Metodo IOpcDigitalSignature::GetPackageObjectReference (msopc.h)

Articolo
03/08/2023

Ottiene un puntatore dell'interfaccia IOpcSignatureReference che rappresenta il riferimento all'elemento Object specifico del pacchetto firmato.

Sintassi

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

Parametri

[out, retval] packageObjectReference

Puntatore dell'interfaccia IOpcSignatureReference che rappresenta il riferimento all'elemento Object specifico del pacchetto firmato.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro packageObjectReference è NULL.

Commenti

Il puntatore dell'interfaccia IOpcSignatureReference ricevuto nel parametro packageObjectReference rappresenta l'elemento Reference con il valore dell'attributo URI impostato su "#idPackageObject". Il valore dell'attributo URI di questo elemento è il valore dell'attributo Id dell'elemento Object specifico del pacchetto, preceduto da un segno di sterlina ("#").

Quando la firma viene generata e serializzata come markup di firma, il riferimento e l'elemento Object specifico del pacchetto a cui si fa riferimento vengono firmati. Il markup seguente mostra l'elemento Reference specifico del pacchetto e l'elemento Object specifico del pacchetto nel markup della firma risultante.

<!-- 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>

Thread safety

Gli oggetti di creazione dei pacchetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API Creazione pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h