Функция WSDUriEncode (wsdutil.h)

Кодирует URI в соответствии с правилами кодирования URI в RFC2396.

Синтаксис

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

Параметры

[in] source

Содержит кодируемый универсальный код ресурса (URI).

[in] cchSource

Указывает длину источника в символах.

[out] destOut

Указатель на строку, содержащую закодированный URI. Если значение destOut не равно NULL, вызывающее приложение должно освободить выделенную строку, вызвав WSDFreeLinkedMemory.

[out, optional] cchDestOut

Указывает длину destOut в символах.

Возвращаемое значение

Эта функция может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Функция успешно завершена.
E_INVALIDARG	source имеет значение NULL или cchSource имеет значение 0.
E_FAIL	Длина символов источника превышает WSD_MAX_TEXT_LENGTH (8192).
E_POINTER	destOut имеет значение NULL.

Комментарии

WSDUriEncode кодирует определенные символы в источнике в экранированный формат кодировки %XY, где X и Y — шестнадцатеричные цифры, соответствующие однобайтового представления этого символа. Расширенные символы, занимающие несколько байтов, сначала преобразуются в многобайтовый формат UTF-8, а затем экранируются в закодированные символы.

WSDUriEncode не кодирует однобайтовые буквенно-цифровые символы. Он кодирует знаки процента (%) в источнике.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	wsdutil.h (включая Wsdapi.h)
Библиотека	Wsdapi.lib
DLL	Wsdapi.dll