Função UrlIsA (shlwapi.h)
Testa se uma URL é um tipo especificado.
Sintaxe
BOOL UrlIsA(
[in] PCSTR pszUrl,
URLIS UrlIs
);
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.
UrlIs
Tipo: URLIS
O tipo de URL para o qual será testado. Esse parâmetro pode ter um dos valores a seguir.
URLIS_APPLIABLE
Tente determinar um esquema válido para a URL.
URLIS_DIRECTORY
A cadeia de caracteres de URL termina com um diretório?
URLIS_FILEURL
A URL é uma URL de arquivo?
URLIS_HASQUERY
A URL tem uma cadeia de caracteres de consulta acrescentada?
URLIS_NOHISTORY
A URL é uma URL que normalmente não é rastreada no histórico de navegação?
URLIS_OPAQUE
URLIS_URL
A URL é válida?
Valor de retorno
Tipo: BOOL
Para todos, exceto um dos tipos de URL, UrlIs retorna VERDADEIRO se a URL for o tipo especificado ou false se não.
Se urlIs estiver definida como URLIS_APPLIABLE, urlIs tentará determinar o esquema de URL. Se a função for capaz de determinar um esquema, ela retornará verdadeiroou false caso contrário.
Observações
Nota
O cabeçalho shlwapi.h define urlIs 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) |
Consulte também
urlIsNoHistory
urlIsOpaque