WsDecodeUrl-Funktion (Webservices.h)

  • Artikel
  • 2 Minuten Lesedauer

Wertet die Komponenten einer URL aus, um sein "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 URL, die ausgewertet werden soll.

[in] flags

Bestimmt die URL-Schemabewertungsmethode. Siehe WS_URL_FLAGS.

[in] heap

Ein Zeiger auf einen WS_HEAP , in dem der zurückgegebene URL-Verweis zugewiesen werden soll.

outUrl

Verweisen Sie auf die WS_URL Struktur, die den WS_URL_SCHEME_TYPE-Wert kapselt.

[in, optional] error

Ein Zeiger auf ein WS_ERROR -Objekt, bei dem zusätzliche Informationen zum Fehler gespeichert werden sollten, 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
 Es wurde der Arbeitsspeicher nicht mehr gespeichert.
WS_E_INVALID_FORMAT
 Die Eingabe-URL war nicht im richtigen Format enthalten, oder das Schema wurde nicht erkannt.
Andere Fehler
Diese Funktion kann andere Fehler zurückgeben, die oben nicht aufgeführt sind.

Bemerkungen

Die Grammatik, die für die Schemas "http", "https", "net.tcp" und "soap.udp" analysiert wurde, 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 von "[" und "]" abgegrenzten Zeichen zurückgegeben. Sie werden nicht erzwungen, um der IPv6Address-Produktion zu folgen.
  • Der Benutzerinfoteil 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 kein Port für das soap.udp-Schema angegeben wird, wird 0xFFFFFFFF als Standard zurückgegeben.

Anforderungen

   
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