WSDUriDecode function (wsdutil.h)

Article
02/22/2024

Decodes a URI according to the rules in RFC2396.

Syntax

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

Parameters

[in] source

Contains the URI to be decoded.

[in] cchSource

Specifies the length of source in characters.

[out] destOut

Pointer to a string that contains the decoded URI. If destOut is not NULL, the calling application should free the allocated string by calling WSDFreeLinkedMemory.

[out, optional] cchDestOut

Specifies the length of destOut in characters.

Return value

This function can return one of these values.

Return code	Description
S_OK	Function completed successfully.
E_INVALIDARG	source is NULL or cchSource is 0.
E_FAIL	The length in characters of source exceeds WSD_MAX_TEXT_LENGTH (8192).
E_POINTER	destOut is NULL.

Remarks

WSDUriDecode decodes any encoded characters in source. These characters are identified by a percent sign (%) followed by two hexadecimal digits. WSDUriDecode decodes single-byte components of multi-byte characters and converts them back to wide character representation in destOut.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	wsdutil.h (include Wsdapi.h)
Library	Wsdapi.lib
DLL	Wsdapi.dll

Share via