WSDUriEncode-Funktion (wsdutil.h)

Artikel
03/13/2024

Codiert einen URI gemäß URI-Codierungsregeln in RFC2396.

Syntax

HRESULT WSDUriEncode(
  [in]            LPCWSTR source,
  [in]            DWORD   cchSource,
  [out]           LPWSTR  *destOut,
  [out, optional] DWORD   *cchDestOut
);

Parameter

[in] source

Enthält den zu codierenden URI.

[in] cchSource

Gibt die Länge der Quelle in Zeichen an.

[out] destOut

Zeiger auf eine Zeichenfolge, die den codierten URI enthält. Wenn destOut nicht NULL ist, sollte die aufrufende Anwendung die zugeordnete Zeichenfolge durch Aufrufen von WSDFreeLinkedMemory freigeben.

[out, optional] cchDestOut

Gibt die Länge von destOut in Zeichen an.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Funktion wurde erfolgreich abgeschlossen.
E_INVALIDARG	source ist NULL oder cchSource ist 0.
E_FAIL	Die Länge in den Zeichen der Quelle überschreitet WSD_MAX_TEXT_LENGTH (8192).
E_POINTER	destOut ist NULL.

Hinweise

WSDUriEncode codiert bestimmte Zeichen in der Quelle in ein Escapecodierungsformat von %XY, wobei X und Y hexadezimale Ziffern sind, die der Einzelbytedarstellung dieses Zeichens entsprechen. Breitzeichen, die mehrere Bytes belegen, werden zuerst im UTF-8-Multi-Byte-Format gerendert und dann in codierte Zeichen mit Escapezeichen versehen.

WSDUriEncode codiert keine alphanumerischen Einzelbytezeichen. Prozentzeichen (%) werden in der Quelle codiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wsdutil.h (include Wsdapi.h)
Bibliothek	Wsdapi.lib
DLL	Wsdapi.dll

Freigeben über