MFCreateURLFromPath-Funktion

[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 kanonische URL.

Syntax

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

Parameter

pwszFilePath [ in, optional]

Eine auf NULL beendete Zeichenfolge, die den Pfad enthält. Die maximale Länge der Zeichenfolge ist INTERNET _ MAX URL _ _ LENGTH.

ppwszFileURL [ out]

Empfängt eine auf NULL beendete Zeichenfolge, die die URL enthält. Der Aufrufer muss die Zeichenfolge durch Aufrufen von CoTaskMemFree freigibt.

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 pwszFilePath-Parameter übergebene Zeichenfolge hat bereits das URL-Format. In diesem Fall wird pszFilePath ohne Änderung einfach in ppszFileURL kopiert.
S _ OK
Die Funktion wurde erfolgreich ausgeführt.

Hinweise

Dieser Funktion ist keine Importbibliothek zugeordnet. Zum Aufrufen dieser Funktion müssen Sie die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch eine Verknüpfung mit Mfplat.dll.

Anforderungen

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

Weitere Informationen

Media Foundation Funktionen