Share via

UrlIsA-Funktion (shlwapi.h)

  • Artikel

Testet, ob eine URL ein angegebener Typ ist.

Syntax

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

Parameter

[in] pszUrl

Typ: PCTSTR

Eine null-endende Zeichenfolge mit maximaler Länge INTERNET_MAX_URL_LENGTH, die die URL enthält.

UrlIs

Typ: URLIS

Der URL-Typ, auf den getestet werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.

URLIS_APPLIABLE

Versuchen Sie, ein gültiges Schema für die URL zu ermitteln.

URLIS_DIRECTORY

Endet die URL-Zeichenfolge mit einem Verzeichnis?

URLIS_FILEURL

Handelt es sich bei der URL um eine Datei-URL?

URLIS_HASQUERY

Enthält die URL eine angefügte Abfragezeichenfolge?

URLIS_NOHISTORY

Handelt es sich bei der URL um eine URL, die normalerweise nicht im Navigationsverlauf nachverfolgt wird?

URLIS_OPAQUE

Ist die URL undurchsichtig?

URLIS_URL

Ist die URL gültig?

Rückgabewert

Typ: BOOL

Für alle URL-Typen bis auf einen der URL-Typen gibt UrlIsTRUE zurück, wenn die URL der angegebene Typ ist, oder FALSE , wenn dies nicht der Fall ist.

Wenn UrlIs auf URLIS_APPLIABLE festgelegt ist, versuchen UrlIs , das URL-Schema zu bestimmen. Wenn die Funktion in der Lage ist, ein Schema zu bestimmen, gibt sie TRUE oder FALSE zurück.

Hinweise

Hinweis

Der shlwapi.h-Header definiert UrlIs als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.0 oder höher)

Weitere Informationen

UrlIsFileUrl

UrlIsNoHistory

UrlIsOpaque