PathCreateFromUrlA-Funktion (shlwapi.h)

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

Syntax

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

Parameter

[in] pszUrl

Typ: PCTSTR-

Eine mit Null beendete Zeichenfolge mit maximaler Länge INTERNET_MAX_URL_LENGTH, die die URL enthält.

[out] pszPath

Typ: PTSTR-

Ein Zeiger auf einen Puffer, der, wenn diese Funktion erfolgreich zurückgegeben wird, den MS-DOS Pfad empfängt. Sie müssen die Größe dieses Puffers auf MAX_PATH festlegen, um sicherzustellen, dass die zurückgegebene Zeichenfolge groß genug ist.

[in, out] pcchPath

Typ: DWORD*-

Die Anzahl der Zeichen im pszPath Puffer.

dwFlags

Typ: DWORD-

Reserviert. Legen Sie diesen Parameter auf NULL-fest.

Rückgabewert

Typ: HRESULT-

Wenn diese Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

Anmerkung

Der Header "shlwapi.h" definiert PathCreateFromUrl 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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)