Função UrlIsA (shlwapi.h)

Artigo
11/20/2024

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

A URL opaca?

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

UrlIsFileUrl

urlIsNoHistory

urlIsOpaque

Compartilhar via