UrlCreateFromPathW-Funktion (shlwapi.h)

  • Artikel

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

Syntax

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

Parameter

[in] pszPath

Typ: PCTSTR

Eine null-endende 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 ein COM-Standardfehlerwert zurückgegeben, falls nicht.

Hinweise

HinweisUrlCreateFromPath unterstützt keine erweiterten Pfade. Dies sind Pfade, die das Pfadpräfix "\\?\" mit erweiterter Länge enthalten.
 

Hinweis

Der shlwapi.h-Header definiert UrlCreateFromPath 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 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
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)