Função PathCreateFromUrlA (shlwapi.h)

Converte uma URL de arquivo em um caminho MS-DOS da Microsoft.

Sintaxe

LWSTDAPI PathCreateFromUrlA(
  [in]      PCSTR pszUrl,
  [out]     PSTR  pszPath,
  [in, out] DWORD *pcchPath,
            DWORD dwFlags
);

Parâmetros

[in] pszUrl

Tipo: PCTSTR

Uma cadeia de caracteres terminada em nulo de comprimento máximo INTERNET_MAX_URL_LENGTH que contém a URL.

[out] pszPath

Tipo: PTSTR

Um ponteiro para um buffer que, quando essa função retorna com êxito, recebe o caminho MS-DOS. Você deve definir o tamanho desse buffer como MAX_PATH para garantir que ele seja grande o suficiente para manter a cadeia de caracteres retornada.

[in, out] pcchPath

Tipo: DWORD*

O número de caracteres no buffer pszPath .

dwFlags

Tipo: DWORD

Reservado. Defina esse parâmetro como NULL.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Observação

O cabeçalho shlwapi.h define PathCreateFromUrl como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 5.0 ou posterior)