IXpsSignatureRequest

署名要求の各構成要素にアクセスします。

IXpsSignatureRequest インターフェイスは、SignatureDefinitons パートのマークアップ内にある単一の SignatureDefinition 要素に対応します。

この SignatureDefinition 要素のマークアップについては、XML Paper Specification のセクション 10.2.2 で説明されています。

すべての署名要求は、署名ブロックの要求コレクションに格納されます。これらは、インスタンス化の元となった IXpsSignatureBlock インターフェイスから独立して存在することはできません。

署名の意図または意味を記述する文字列を設定します。(IXpsSignatureRequest.GetIntent)

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

署名意図の文字列は、その署名が署名者にとって何を意味するのかを記述します。たとえば、署名意図の文字列が「I have read and agree with the contents of this document」である場合、デジタル署名が存在することは、署名者がそのドキュメントの内容を読み、その内容に同意したことを意味します。

このメソッドは、intent で返される文字列に使用されるメモリを割り当てます。intent が NULL でない場合は、CoTaskMemFree 関数を使用してメモリを解放してください。

署名の意図または意味を記述する文字列を設定します。(IXpsSignatureRequest.SetIntent)

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

署名意図の文字列は、その署名が署名者にとって何を意味するのかを記述します。たとえば、署名意図の文字列が「I have read and agree with the contents of this document」である場合、デジタル署名が存在することは、署名者がそのドキュメントの内容を読み、その内容に同意したことを意味します。

パッケージに署名した人物、または署名を要求している人物の識別情報を取得します。

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

このメソッドは、signerName で返される文字列に使用されるメモリを割り当てます。signerName が NULL でない場合は、CoTaskMemFree 関数を使用してメモリを解放してください。

パッケージに署名した人物、または署名を要求された人物の識別情報を設定します。

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

要求された署名者がドキュメントの指定されたパートに署名しなければならない期限の日時を取得します。

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

このメソッドは、dateString で返される文字列に使用されるメモリを割り当てます。dateString が NULL でない場合は、CoTaskMemFree 関数を使用してメモリを解放してください。

要求された署名者がドキュメントの指定されたパートに署名しなければならない期限の日時を設定します。

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

パッケージの署名場所に関する法的管轄区域を取得します。

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

このメソッドは、place で返される文字列に使用されるメモリを割り当てます。place が NULL でない場合は、CoTaskMemFree 関数を使用してメモリを解放してください。

パッケージの署名場所に関する法的管轄区域を設定します。

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

可視のデジタル署名またはデジタル署名要求が表示されるページと、そのページ上の位置を取得します。

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

署名スポットの位置は、ページの左上隅を基準とした XPS 単位で指定されます。1 インチあたり 96 XPS 単位です。

可視のデジタル署名またはデジタル署名要求を表示するページと、そのページ上の位置を指定します。

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

署名スポットの位置は、ページの左上隅を基準とした XPS 単位で指定されます。1 インチあたり 96 XPS 単位です。

署名要求の一意の識別子を取得します。

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。

このメソッドは、requestId で返される文字列に使用されるメモリを割り当てます。requestId が NULL でない場合は、CoTaskMemFree 関数を使用してメモリを解放してください。

requestId パラメーターは、SignatureDefinition 要素の SpotID 属性の値を受け取ります。SpotID 属性は必須であり、xs:ID (XML ID) 形式に従う必要がありますが、既存の SignatureDefinitions パートについては、推奨形式に準拠しているかどうかは検査されません。Windows Presentation Foundation (WPF) アプリケーションによって生成された一部の XPS ドキュメントでは、ID が数字で始まっている場合があります。

署名要求と同じ一意の識別子を持つ XPS デジタル署名を含む IXpsSignature インターフェイスへのポインターを取得します。

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。この表に記載されていない戻り値については、XPS Digital Signature API Errors および XPS Document Errors を参照してください。