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

Artigo
03/05/2024

Cria um ponteiro de interface IOpcSignaturePartReference que representa uma referência a uma parte a ser assinada e adiciona a nova interface ao conjunto.

Sintaxe

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

Parâmetros

[in] partUri

Um IOpcPartUri que representa o nome da parte a ser referenciada.

[in] digestMethod

O método digest a ser usado para o conteúdo de parte da parte a ser referenciada. Para usar o método digest padrão, passe NULL para esse parâmetro.

Importante O método digest padrão deve ser definido chamando o método IOpcSigningOptions::SetDefaultDigestMethod antes que IOpcDigitalSignatureManager::Sign seja chamado.

[in] transformMethod

O método de canonicalização usado para o conteúdo de parte da parte a ser referenciada.

[out, retval] partReference

Um novo ponteiro de interface IOpcSignaturePartReference que representa a referência à parte a ser assinada.

Esse parâmetro poderá ser NULL se um ponteiro para a nova interface não for necessário.

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_INVALIDARG	O valor passado no parâmetro transformMethod não é válido OPC_CANONICALIZATION_METHOD valor de enumeração.
E_POINTER	O parâmetro partUri é NULL.

Comentários

Somente as partes que podem ser representadas pela interface IOpcPart podem ser referenciadas por um ponteiro de interface IOpcSignaturePartReference . As partes de relações são referenciadas para assinatura por um ponteiro para a interface IOpcSignatureRelationshipReference . Para criar um ponteiro de interface IOpcSignatureRelationshipReference , chame o método IOpcSignatureRelationshipReferenceSet::Create .

Quando um ponteiro de interface IOpcSignaturePartReference é criado e adicionado ao conjunto, a referência que ele representa é salva quando o pacote é salvo.

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