Método IOpcSignaturePartReferenceSet::Create (msopc.h)

Artículo
03/08/2023

Crea un puntero de interfaz IOpcSignaturePartReference que representa una referencia a un elemento que se va a firmar y agrega la nueva interfaz al conjunto.

Sintaxis

HRESULT Create(
  [in]          IOpcPartUri                 *partUri,
  [in]          LPCWSTR                     digestMethod,
  [in]          OPC_CANONICALIZATION_METHOD transformMethod,
  [out, retval] IOpcSignaturePartReference  **partReference
);

Parámetros

[in] partUri

IOpcPartUri que representa el nombre del elemento al que se va a hacer referencia.

[in] digestMethod

Método de resumen que se va a usar para el contenido de parte de la parte a la que se va a hacer referencia. Para usar el método de resumen predeterminado, pase NULL a este parámetro.

Importante El método de resumen predeterminado debe establecerse llamando al método IOpcSigningOptions::SetDefaultDigestMethod antes de llamar a IOpcDigitalSignatureManager::Sign .

[in] transformMethod

Método de canonización utilizado para el contenido de parte de la parte a la que se va a hacer referencia.

[out, retval] partReference

Nuevo puntero de interfaz IOpcSignaturePartReference que representa la referencia al elemento que se va a firmar.

Este parámetro puede ser NULL si no se necesita un puntero a la nueva interfaz.

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_INVALIDARG	El valor pasado en el parámetro transformMethod no es un valor de enumeración OPC_CANONICALIZATION_METHOD válido.
E_POINTER	El parámetro partUri es NULL.

Comentarios

Solo un puntero de interfaz IOpcPart puede hacer referencia a partes que pueden representarse mediante un puntero de interfaz IOpcSignaturePartReference . Se hace referencia a las partes de relaciones para firmar mediante un puntero a la interfaz IOpcSignatureRelationshipReference . Para crear un puntero de interfaz IOpcSignatureRelationshipReference , llame al método IOpcSignatureRelationshipReferenceSet::Create .

Cuando se crea un puntero de interfaz IOpcSignaturePartReference y se agrega al conjunto, la referencia que representa se guarda cuando se guarda el paquete.

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