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 の長さを文字で指定します。
戻り値
この関数は、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
関数は正常に完了しました。 |
|
source が NULL であるか 、cchSource が 0 です。 |
|
source の文字数がWSD_MAX_TEXT_LENGTH (8192) を超えています。 |
|
destOut は NULL です。 |
注釈
WSDUriEncode は 、ソース 内の特定の文字を %XY のエスケープされたエンコード形式にエンコードします。ここで、X と Y は、その文字の 1 バイト表現に対応する 16 進数です。 複数のバイトを占めるワイド文字は、最初に UTF-8 マルチバイト形式でレンダリングされ、エンコードされた文字にエスケープされます。
WSDUriEncode では、1 バイトの英数字はエンコードされません。 ソースでパーセント記号 (%) をエンコード します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wsdutil.h (Wsdapi.h を含む) |
Library | Wsdapi.lib |
[DLL] | Wsdapi.dll |