Condividi tramite


Metodo IOpcSignaturePartReferenceSet::Create (msopc.h)

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

Vedi anche

Interfacce di creazione di pacchetti principali

Introduzione con l'API per la creazione di pacchetti

IOpcDigitalSignatureManager

IOpcSignaturePartReferenceSet

IOpcSignatureRelationshipReferenceSet

IOpcSigningOptions

OPC_CANONICALIZATION_METHOD

Cenni preliminari

Guida alla programmazione dell'API per la creazione di pacchetti

Informazioni di riferimento sulle API per la creazione di pacchetti

Esempi di API per la creazione di pacchetti

Creazione di pacchetti di interfacce di firma digitale

Interfacce di creazione di pacchetti

Riferimento