Função PathCreateFromUrlW (shlwapi.h)

Artigo
11/20/2024

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

Sintaxe

LWSTDAPI PathCreateFromUrlW(
  [in]      PCWSTR pszUrl,
  [out]     PWSTR  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 para 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 de pszPath .

dwFlags

Tipo: DWORD

Reservado. Defina esse parâmetro para NULL.

Valor de retorno

Tipo: HRESULT

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

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Compartilhar via