WSDUriEncode function (wsdutil.h)

Encodes a URI according to URI encoding rules in RFC2396.

Syntax

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

Parameters

[in] source

Contains the URI to be encoded.

[in] cchSource

Specifies the length of source in characters.

[out] destOut

Pointer to a string that contains the encoded 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.

Remarks

WSDUriEncode encodes certain characters in source into an escaped encoding format of %XY, where X and Y are hexadecimal digits corresponding to the single-byte representation of that character. Wide characters that occupy multiple bytes are first rendered into UTF-8 multi-byte format, and then escaped into encoded characters.

WSDUriEncode does not encode single-byte alphanumeric characters. It does encode percent signs (%) in source.

Requirements