Função MFCreateURLFromPath

  • Artigo

[Essa API não tem suporte e pode ser alterada ou indisponível no futuro. Em vez disso, os aplicativos devem chamar UrlCreateFromPath.]

Converte um caminho MS-DOS da Microsoft em uma URL canônica.

Sintaxe

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

Parâmetros

pwszFilePath [in, opcional]

Uma cadeia de caracteres terminada em nulo que contém o caminho. O comprimento máximo da cadeia de caracteres é INTERNET_MAX_URL_LENGTH.

ppwszFileURL [out]

Recebe uma cadeia de caracteres terminada em nulo que contém a URL. O chamador deve liberar a cadeia de caracteres chamando CoTaskMemFree.

Valor retornado

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_FALSE
 A cadeia de caracteres fornecida no parâmetro pwszFilePath já está no formato de URL. Nesse caso, pszFilePath é simplesmente copiado para ppszFileURL sem modificação.
S_OK
 A função foi bem-sucedida.

 

Comentários

Essa função não tem biblioteca de importação associada. Para chamar essa função, você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Mfplat.dll.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 [somente aplicativos da área de trabalho]
DLL
Mfplat.dll

Confira também

Funções do Media Foundation