Funzione UrlIsA (shlwapi.h)

Articolo
20/11/2024

Verifica se un URL è un tipo specificato.

Sintassi

BOOL UrlIsA(
  [in] PCSTR pszUrl,
       URLIS UrlIs
);

Parametri

[in] pszUrl

Tipo: PCTSTR

Stringa con terminazione Null di lunghezza massima INTERNET_MAX_URL_LENGTH che contiene l'URL.

UrlIs

Tipo: URLIS

Tipo di URL da testare. Questo parametro può accettare uno dei valori seguenti.

URLIS_APPLIABLE

Tentare di determinare uno schema valido per l'URL.

URLIS_DIRECTORY

La stringa URL termina con una directory?

URLIS_FILEURL

L'URL è un URL di file?

URLIS_HASQUERY

L'URL ha una stringa di query accodata?

URLIS_NOHISTORY

L'URL è un URL non rilevato in genere nella cronologia di navigazione?

URLIS_OPAQUE

L'URL opaco?

URLIS_URL

L'URL è valido?

Valore restituito

Tipo: bool

Per tutti i tipi di URL, url restituisce true se l'URL è il tipo specificato oppure FALSE in caso contrario.

Se URL è impostato su URLIS_APPLIABLE, URL tenterà di determinare lo schema URL. Se la funzione è in grado di determinare uno schema, restituisce TRUEo false in caso contrario.

Osservazioni

Nota

L'intestazione shlwapi.h definisce UrlIs come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 5.0 o successiva)

Vedere anche

UrlIsFileUrl

UrlIsNoHistory

UrlIsOpaque

Condividi tramite