IOpcSignatureReference インターフェイス (msopc.h)

[アーティクル]
08/25/2023

署名または署名される XML マークアップへの参照を表します。この参照される XML マークアップは、署名が生成されるときに署名マークアップでシリアル化されます。

継承

IOpcSignatureReference インターフェイスは、IUnknown インターフェイスから継承します。 IOpcSignatureReference には、次の種類のメンバーもあります。

メソッド

IOpcSignatureReference インターフェイスには、これらのメソッドがあります。


IOpcSignatureReference::GetDigestMethod 参照先の XML 要素で使用するダイジェストメソッドを、要素が署名されたときに取得します。
IOpcSignatureReference::GetDigestValue 要素が署名されたときに参照される XML 要素に対して計算されるダイジェスト値を取得します。
IOpcSignatureReference::GetId 参照の識別子を取得します。
IOpcSignatureReference::GetTransformMethod 要素が署名されたときに、参照先の XML 要素で使用する正規化メソッドを取得します。
IOpcSignatureReference::GetType 参照先の XML 要素の型を示す文字列を取得します。
IOpcSignatureReference::GetUri 参照先の XML 要素の URI を取得します。

解説

IOpcSignatureReference インターフェイスポインターを作成するには、IOpcSignatureReferenceSet::Create メソッドを呼び出します。 IOpcSignatureReferenceSet::Create では、パッケージ固有の Object 要素への参照は作成されません。この参照は、署名の生成時に自動的に作成されます。

IOpcSignatureReference インターフェイスポインターにアクセスするには、IOpcSignatureReferenceEnumerator::GetCurrent メソッドを呼び出します。 IOpcSignatureReferenceEnumerator::GetCurrent は、パッケージ固有の Object 要素への参照にアクセスしません。その参照にアクセスするには、 IOpcDigitalSignature::GetPackageObjectReference メソッドを呼び出します。

インターフェイスには、参照自体と参照される XML 要素に関する情報にアクセスするためのメソッドが用意されています。参照される要素には、パッケージ固有の Object 要素、アプリケーション固有の Object 要素、またはアプリケーション固有の Object の子要素を指定できます。

署名が生成されると、この参照情報は署名の XML マークアップ (署名マークアップ) でシリアル化されます。シグネチャマークアップでは、情報は、URI 属性値が "#" に設定され、その後に参照される要素の Id 属性値が続く Reference 要素によって表されます。たとえば、参照される要素の Id 属性が "Application" の場合、Reference 要素の URI 属性は、次のマークアップに示すように "#Application" に設定されます。

次のシグネチャマークアップは、署名されたアプリケーション固有の Object 要素へのシリアル化された参照を示しています。

<Signature Id="SignatureId" xmlns="http://www.w3.org/2000/09/xmldsig#">
    <SignedInfo>
        [...]
        <Reference URI="#idPackageObject" ...>
            [...]
        </Reference>
        <!-- This reference indicates that the application-specific
        Object element was signed when the signature was generated.-->
        <Reference URI="#Application" ...>
            [...]
        </Reference>
    </SignedInfo>
    [...]
    <Object Id="idPackageObject" ...>
        [...]
    </Object>
    <!-- This application-specific <Object> element was signed when the
    signature was generated. -->
    <Object Id="Application">
        [...]
    </Object>
</Signature>

次のシグネチャマークアップは、アプリケーション固有の Object 要素の署名された子要素へのシリアル化された参照を示しています。

メモアプリケーション固有の Object の複数の子要素を、署名のために参照できます。

<Signature Id="SignatureId" xmlns="http://www.w3.org/2000/09/xmldsig#">
    <SignedInfo>
        [...]
        <Reference URI="#idPackageObject" ...>
            [...]
        </Reference>
        <!-- This reference indicates that MyElement in the application
        -specific Object element was signed when the signature was
        generated. -->
        <Reference URI="#MyElementId" ...>
            [...]
        </Reference>
    </SignedInfo>
    [...]
    <Object Id="idPackageObject" ...>
        [...]
    </Object>
    <Object Id="Application">
        [...]
            <!-- This element is signed. -->
            <MyElement Id="MyElementId">
                [...]
            </MyElement>
        [...]
    </Object>
</Signature>

要件


サポートされている最小のクライアント	Windows 7 [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	msopc.h

IOpcSignatureReference インターフェイス (msopc.h)

継承

メソッド

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース