Share via

Função UrlIsW (shlwapi.h)

  • Artigo

Testa se uma URL é um tipo especificado.

Sintaxe

BOOL UrlIsW(
  [in] PCWSTR 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 a 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?

Retornar valor

Tipo: BOOL

Para todos, exceto um dos tipos de URL, urlIs retornarãoTRUE se a URL for o tipo especificado ou FALSE se não for.

Se as URLIs estiverem definidas como URLIS_APPLIABLE, as URLIs tentarão determinar o esquema de URL. Se a função for capaz de determinar um esquema, ela retornará TRUE ou FALSE caso contrário.

Comentários

Observação

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 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)

Confira também

UrlIsFileUrl

UrlIsNoHistory

UrlIsOpaque