PathCreateFromUrlW-Funktion (shlwapi.h)

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

Syntax

LWSTDAPI PathCreateFromUrlW(
  [in]      PCWSTR pszUrl,
  [out]     PWSTR  pszPath,
  [in, out] DWORD  *pcchPath,
            DWORD  dwFlags
);

Parameter

[in] pszUrl

Typ: PCTSTR

Eine NULL-Zeichenfolge mit maximaler Länge INTERNET_MAX_URL_LENGTH, die die URL enthält.

[out] pszPath

Typ: PTSTR

Ein Zeiger auf einen Puffer, der bei erfolgreicher Rückgabe dieser Funktion den MS-DOS-Pfad empfängt. Sie müssen die Größe dieses Puffers auf MAX_PATH festlegen, um sicherzustellen, dass er groß genug ist, um die zurückgegebene Zeichenfolge zu enthalten.

[in, out] pcchPath

Typ: DWORD*

Die Anzahl der Zeichen im pszPath-Puffer .

dwFlags

Art: DWORD

Reserviert. Legen Sie diesen Parameter auf NULL fest.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Hinweis

Der shlwapi.h-Header definiert PathCreateFromUrl als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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)