共用方式為

WSDUriEncode 函式 (wsdutil.h)

  • 發行項

根據 RFC2396中的 URI 編碼規則來編碼 URI。

語法

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
 來源字元的長度超過 ( 8192) WSD_MAX_TEXT_LENGTH。
E_POINTER
 destOut 為 NULL。

備註

WSDUriEncode 會將 來源 中的特定字元編碼成 %XY 的逸出編碼格式，其中 X 和 Y 是對應至該字元之單一位元組表示法的十六進位數位。 佔用多個字節的寬字元會先轉譯成 UTF-8 多位元組格式，然後再逸出成編碼字元。

WSDUriEncode 不會編碼單一位元組英數位元。 它會在 來源中編碼百分比符號 (%) 。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 wsdutil.h (包含 Wsdapi.h)
程式庫 Wsdapi.lib
Dll Wsdapi.dll