UrlIsA-Funktion (shlwapi.h)
Überprüft, ob eine URL ein angegebener Typ ist.
Syntax
BOOL UrlIsA(
[in] PCSTR pszUrl,
URLIS UrlIs
);
Parameter
[in] pszUrl
Typ: PCTSTR-
Eine mit Null beendete Zeichenfolge mit maximaler Länge INTERNET_MAX_URL_LENGTH, die die URL enthält.
UrlIs
Typ: URLIS-
Der Typ der URL, auf die 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
Ist die URL eine Datei-URL?
URLIS_HASQUERY
Verfügt die URL über eine angefügte Abfragezeichenfolge?
URLIS_NOHISTORY
Ist die URL eine URL, die in der Regel 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 gibt URLIsTRUE zurück, wenn die URL der angegebene Typ ist, oder FALSE- wenn dies nicht der Fall ist.
Wenn URLIs auf URLIS_APPLIABLEfestgelegt ist, versucht URLIs, das URL-Schema zu ermitteln. Wenn die Funktion ein Schema bestimmen kann, gibt sie TRUEzurück oder FALSE andernfalls.
Bemerkungen
Anmerkung
Der Header "shlwapi.h" 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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | shlwapi.h |
| Library | Shlwapi.lib |
| DLL- | Shlwapi.dll (Version 5.0 oder höher) |