Méthode IOpcDigitalSignature ::GetPackageObjectReference (msopc.h)

Article
02/29/2024

Obtient un pointeur d’interface IOpcSignatureReference qui représente la référence à l’élément Object spécifique au package qui a été signé.

Syntaxe

HRESULT GetPackageObjectReference(
  [out, retval] IOpcSignatureReference **packageObjectReference
);

Paramètres

[out, retval] packageObjectReference

Pointeur d’interface IOpcSignatureReference qui représente la référence à l’élément Object spécifique au package qui a été signé.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_POINTER	Le paramètre packageObjectReference est NULL.

Remarques

Le pointeur d’interface IOpcSignatureReference reçu dans le paramètre packageObjectReference représente l’élément Reference dont la valeur de l’attribut URI est définie sur « #idPackageObject ». La valeur de l’attribut URI de cet élément est la valeur d’attribut Id de l’élément Object spécifique au package, précédée d’un signe pound (« # »).

Lorsque la signature est générée et sérialisée en tant que balisage de signature, la référence et l’élément Object spécifique au package référencé sont signés. Le balisage suivant montre l’élément Reference spécifique au package et l’élément Object spécifique au package dans le balisage de signature résultant.

<!-- Signature markup. -->
<Signature>
    <SignedInfo>
        [...]
        <!-- A reference to the package-specific <Object> that
        is, or will be, signed. -->
        <Reference URI="#idPackageObject">
             [...]
        </Reference>
    </SignedInfo>
    [...]
    <!-- The package-specific <Object> element. -->
    <Object Id="idPackageObject">
        <!-- This element contains the <Reference> elements that
        refer to parts and relationships in the package that are
        or will be signed. -->
        <Manifest>
            [...] 
        </Manifest>
    </Object>
</Signature>

Cohérence de thread

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API Packaging.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msopc.h