WsEncodeUrl-Funktion (webservices.h)

Artikel
03/03/2024

Codiert die angegebene WS_URL in eine URL-Zeichenfolge angesichts der Komponententeile. Werte werden nach Bedarf mit Escapezeichen versehen, kombiniert und in der angegebenen WS_HEAP gespeichert, und das Ergebnis wird als WS_STRING zurückgegeben.

Syntax

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

Parameter

[in] url

Ein Verweis auf die zu codierende WS_URL.

[in] flags

Der Wert dieses Parameters bestimmt die Methode der URL-Schemaauswertung. Siehe WS_URL_FLAGS.

[in] heap

Ein Zeiger auf einen WS_HEAP , in dem die URL zugewiesen werden soll.

[out] outUrl

Ein Zeiger auf die resultierende URL-Zeichenfolge.

[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 zu codierenden URL-Daten waren gemäß der URL-Syntax ungültig.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Wenn ein Schema im URL-Parameter nicht erkannt wird, gibt die Funktion WS_E_INVALID_FORMAT zurück.
Nur in WS_URL_SCHEME_TYPE identifizierte Schematypen werden unterstützt.

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

Freigeben über