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

Artículo
08/25/2023

Obtiene un puntero de interfaz IOpcSignatureReference que representa la referencia al elemento Object específico del paquete que se ha firmado.

Sintaxis

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

Parámetros

[out, retval] packageObjectReference

Puntero de interfaz IOpcSignatureReference que representa la referencia al elemento Object específico del paquete que se ha firmado.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	El parámetro packageObjectReference es NULL.

Comentarios

El puntero de interfaz IOpcSignatureReference recibido en el parámetro packageObjectReference representa el elemento Reference que tiene el valor del atributo URI establecido en "#idPackageObject". El valor del atributo URI de este elemento es el valor del atributo Id del elemento Object específico del paquete, prefijo con un signo de libra ("#").

Cuando se genera y serializa la firma como marcado de firma, se firma la referencia y el elemento Object específico del paquete al que se hace referencia. El marcado siguiente muestra el elemento Reference específico del paquete y el elemento Object específico del paquete en el marcado de firma 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>

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para más información, consulte la Introducción con la API de empaquetado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h