WsDecodeUrl-Funktion (webservices.h)

  • Artikel

Wertet die Komponenten einer URL aus, um deren "Schema" zu bestimmen. Ein WS_URL_SCHEME_TYPE Wert wird in einer WS_URL-Struktur gekapselt, und ein Verweis auf die Struktur wird über den Ausgabeparameter zurückgegeben. Wenn das Schema nicht erkannt wird, gibt die Funktion WS_E_INVALID_FORMAT zurück.
Nur in WS_URL_SCHEME_TYPE identifizierte Schematypen werden unterstützt.

Syntax

HRESULT WsDecodeUrl(
  [in]           const WS_STRING *url,
  [in]           ULONG           flags,
  [in]           WS_HEAP         *heap,
                 WS_URL          **outUrl,
  [in, optional] WS_ERROR        *error
);

Parameter

[in] url

Ein Zeiger auf eine WS_STRING Darstellung der auszuwertenden URL.

[in] flags

Bestimmt die Methode zur Auswertung des URL-Schemas. Weitere Informationen finden Sie unter WS_URL_FLAGS.

[in] heap

Ein Zeiger auf eine WS_HEAP , in der der zurückgegebene URL-Verweis zugeordnet werden soll.

outUrl

Verweis auf die WS_URL-Struktur , die den WS_URL_SCHEME_TYPE-Wert kapselt.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
E_INVALIDARG
 Mindestens ein Argument ist ungültig.
E_OUTOFMEMORY
 Der Arbeitsspeicher ist nicht mehr vorhanden.
WS_E_INVALID_FORMAT
 Die Eingabe-URL hatte nicht das richtige Format, oder das Schema wurde nicht erkannt.
Andere Fehler
Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Die für die Schemas "http", "https", "net.tcp" und "soap.udp" analysierte Grammatik finden Sie unter http://www.ietf.org/rfc/rfc3986.txt. Für diese Schemas:

  • Ein nicht leerer Hostname ist erforderlich.
  • Für die IP-Literalproduktion werden alle durch "[" und "]" abgegrenzten Zeichen zurückgegeben. Sie werden nicht erzwungen, um der IPv6Address-Produktion zu folgen.
  • Der Userinfo-Teil der Autorität (z. B. userinfo@hostname:port) wird nicht unterstützt.

Wenn kein Port angegeben wird, wird der Standardport für dieses Schema zurückgegeben.

Wenn für das Soap.udp-Schema kein Port angegeben ist, wird 0xFFFFFFFF als Standard zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll