UrlCreateFromPathA-Funktion (shlwapi.h)

  • Artikel

Konvertiert einen Microsoft MS-DOS-Pfad in eine kanonisierte URL.

Syntax

LWSTDAPI UrlCreateFromPathA(
  [in]      PCSTR pszPath,
  [out]     PSTR  pszUrl,
  [in, out] DWORD *pcchUrl,
            DWORD dwFlags
);

Parameter

[in] pszPath

Typ: PCTSTR

Eine NULL-Zeichenfolge mit maximaler Länge INTERNET_MAX_URL_LENGTH, die den MS-DOS-Pfad enthält.

[out] pszUrl

Typ: PTSTR

Ein Zeiger auf einen Puffer, der die URL empfängt, wenn diese Funktion erfolgreich zurückgegeben wird.

[in, out] pcchUrl

Typ: DWORD*

Die Anzahl der Zeichen in pszUrl.

dwFlags

Art: DWORD

Reserviert. Legen Sie diesen Parameter auf NULL fest.

Rückgabewert

Typ: HRESULT

Gibt S_FALSE zurück, wenn pszPath bereits im URL-Format vorliegt. In diesem Fall wird pszPath einfach in pszUrl kopiert. Andernfalls wird bei erfolgreicher Ausführung S_OK oder andernfalls ein COM-Standardfehlerwert zurückgegeben.

Hinweise

HinweisUrlCreateFromPath unterstützt keine erweiterten Pfade. Dabei handelt es sich um Pfade, die das Pfadpräfix "\\?\" mit erweiterter Länge enthalten.
 

Hinweis

Der shlwapi.h-Header definiert UrlCreateFromPath als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.0 oder höher)