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

Artigo
02/29/2024

Obtém um ponteiro de interface IOpcSignatureReference que representa a referência ao elemento Object específico do pacote que foi assinado.

Sintaxe

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

Parâmetros

[out, retval] packageObjectReference

Um ponteiro de interface IOpcSignatureReference que representa a referência ao elemento Object específico do pacote que foi assinado.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro packageObjectReference é NULL.

Comentários

O ponteiro da interface IOpcSignatureReference recebido no parâmetro packageObjectReference representa o elemento Reference que tem o valor do atributo URI definido como "#idPackageObject". O valor do atributo URI desse elemento é o valor do atributo Id do elemento Object específico do pacote, prefixado com um sinal de libra ("#").

Quando a assinatura é gerada e serializada como marcação de assinatura, a referência e o elemento Object específico do pacote referenciado são assinados. A marcação a seguir mostra o elemento Reference específico do pacote e o elemento Object específico do pacote na marcação de assinatura resultante.

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

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h