Função UrlGetLocationW (shlwapi.h)

Recupera o local de uma URL.

Sintaxe

LPCWSTR UrlGetLocationW(
  [in] PCWSTR pszURL
);

Parâmetros

[in] pszURL

Tipo: PCTSTR

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

Valor de retorno

Tipo: LPCTSTR

Retorna um ponteiro para uma cadeia de caracteres terminada em nulo com o local ou NULL caso contrário.

Observações

O local é o segmento da URL começando com um ? ou caractere #. Se uma URL de arquivo tiver uma cadeia de caracteres de consulta, a cadeia de caracteres retornada incluirá a cadeia de caracteres de consulta.

Nota

O cabeçalho shlwapi.h define UrlGetLocation 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)