IXpsSignatureRequest::GetRequestId メソッド (xpsdigitalsignature.h)
署名要求の一意識別子を取得します。
構文
HRESULT GetRequestId(
[out, retval] LPWSTR *requestId
);
パラメーター
[out, retval] requestId
署名要求の一意識別子。
戻り値
このメソッドは HRESULT を返します。 使用可能な値には、次の表に含まれる値が含まれますが、これらに限定されません。 この表に記載されていない戻り値については、「 XPS デジタル署名 API エラー と XPS ドキュメント エラー」を参照してください。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
requestId が NULL です。 |
|
インターフェイスが署名マネージャーに接続されていません。 |
注釈
このメソッドは、 requestId で返される文字列で使用されるメモリを割り当てます。 requestId が NULL でない場合は、CoTaskMemFree 関数を使用してメモリを解放します。
requestId パラメーターは、SignatureDefinition 要素の SpotID 属性の値を受け取ります。 SpotID 属性は必須であり、xs:ID (XML ID) 形式に従う必要があります。ただし、既存の SignatureDefinitions パーツでは、推奨される形式に準拠しているかどうかは確認されません。 Windows Presentation Foundation (WPF) アプリケーションによって生成された一部の XPS ドキュメントには、数字で始まる ID が含まれる場合があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | xpsdigitalsignature.h |