IXpsSignatureRequest::GetIntent メソッド (xpsdigitalsignature.h)
署名の意図または意味を説明する文字列を設定します。
構文
HRESULT GetIntent(
[out, retval] LPWSTR *intent
);
パラメーター
[out, retval] intent
署名者が署名する署名意図契約。
戻り値
このメソッドは HRESULT を返します。 使用可能な値には、次の表に含まれる値が含まれますが、これらに限定されません。 この表に記載されていない戻り値については、「 XPS デジタル署名 API エラー と XPS ドキュメント エラー」を参照してください。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
intent は NULL です。 |
|
インターフェイスが署名マネージャーに接続されていません。 |
注釈
署名意図文字列は、署名者に対する署名の意味を表します。 たとえば、署名意図文字列 "このドキュメントの内容を読んで同意しました" の場合、デジタル署名の存在は、署名者がドキュメントの内容を読んで同意したことを意味します。
このメソッドは、 意図で返される文字列によって使用されるメモリを割り当てます。 intent が NULL でない場合は、CoTaskMemFree 関数を使用してメモリを解放します。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | xpsdigitalsignature.h |