Metodo IOpcSignaturePartReferenceSet::Create (msopc.h)

Articolo
02/29/2024

Crea un puntatore all'interfaccia IOpcSignaturePartReference che rappresenta un riferimento a una parte da firmare e aggiunge la nuova interfaccia al set.

Sintassi

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

Parametri

[in] partUri

Oggetto IOpcPartUri che rappresenta il nome della parte a cui fare riferimento.

[in] digestMethod

Metodo digest da utilizzare per il contenuto della parte a cui fare riferimento. Per usare il metodo digest predefinito, passare NULL a questo parametro.

Importante Il metodo digest predefinito deve essere impostato chiamando il metodo IOpcSigningOptions::SetDefaultDigestMethod prima che venga chiamato IOpcDigitalSignatureManager::Sign .

[in] transformMethod

Metodo di canonizzazione utilizzato per il contenuto della parte a cui fare riferimento.

[out, retval] partReference

Nuovo puntatore all'interfaccia IOpcSignaturePartReference che rappresenta il riferimento alla parte da firmare.

Questo parametro può essere NULL se non è necessario un puntatore alla nuova interfaccia.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Il valore passato nel parametro transformMethod non è un valore di enumerazione valido OPC_CANONICALIZATION_METHOD .
E_POINTER	Il parametro partUri è NULL.

Commenti

Solo le parti che possono essere rappresentate dall'interfaccia IOpcPart possono essere referenziate da un puntatore all'interfaccia IOpcSignaturePartReference . Alle parti delle relazioni viene fatto riferimento per la firma da un puntatore all'interfaccia IOpcSignatureRelationshipReference . Per creare un puntatore all'interfaccia IOpcSignatureRelationshipReference , chiamare il metodo IOpcSignatureRelationshipReferenceSet::Create .

Quando un puntatore all'interfaccia IOpcSignaturePartReference viene creato e aggiunto al set, il riferimento che rappresenta viene salvato quando il pacchetto viene salvato.

Thread safety

I pacchetti degli oggetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API per la creazione di 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