MFCreateURLFromPath-Funktion

Artikel
06/12/2023

[Diese API wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen sollten Anwendungen UrlCreateFromPath aufrufen.]

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

Syntax

HRESULT MFCreateURLFromPath(
  _In_opt_ LPCWSTR pwszFilePath,
  _Out_    LPWSTR  *ppwszFileURL
);

Parameter

pwszFilePath [in, optional]: Eine NULL-endende Zeichenfolge, die den Pfad enthält. Die maximale Länge der Zeichenfolge ist INTERNET_MAX_URL_LENGTH.
ppwszFileURL [out]: Empfängt eine NULL-endende Zeichenfolge, die die URL enthält. Der Aufrufer muss die Zeichenfolge durch Aufrufen von CoTaskMemFree freigeben.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	Beschreibung
S_FALSE	Die im parameter pwszFilePath angegebene Zeichenfolge weist bereits das URL-Format auf. In diesem Fall wird pszFilePath einfach ohne Änderung in ppszFileURL kopiert.
S_OK	Die Funktion wurde erfolgreich ausgeführt.

Bemerkungen

Diese Funktion verfügt über keine zugeordnete Importbibliothek. Um diese Funktion aufzurufen, müssen Sie die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit Mfplat.dll zu verknüpfen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
DLL	Mfplat.dll

Siehe auch

Media Foundation-Funktionen

Share via