Функция MFCreateURLFromPath

Статья
06/12/2023

[Этот API не поддерживается и может быть изменен или недоступен в будущем. Вместо этого приложения должны вызывать UrlCreateFromPath.]

Преобразует путь Microsoft MS-DOS в канонизированный URL-адрес.

Синтаксис

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

Параметры

pwszFilePath [in, необязательный]: Строка, завершающаяся значением NULL, содержащая путь. Максимальная длина строки — INTERNET_MAX_URL_LENGTH.
ppwszFileURL [out]: Получает строку, завершающуюся значением NULL, которая содержит URL-адрес. Вызывающий объект должен освободить строку, вызвав CoTaskMemFree.

Возвращаемое значение

Функция возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_FALSE	Строка, указанная в параметре pwszFilePath , уже имеет формат URL-адреса. В этом случае pszFilePath просто копируется в ppszFileURL без изменений.
S_OK	Функция выполнена успешно.

У этой функции нет связанной библиотеки импорта. Чтобы вызвать эту функцию, необходимо использовать функции LoadLibrary и GetProcAddress для динамического связывания с Mfplat.dll.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
DLL	Mfplat.dll

См. также раздел

Функции Media Foundation

Share via