Interfaccia IOpcDigitalSignatureManager (msopc.h)

Articolo
03/05/2024

Fornisce l'accesso alle interfacce di creazione di pacchetti di firme digitali per un pacchetto rappresentato dagli oggetti DELL'API di creazione di pacchetti. Questi metodi di interfaccia vengono chiamati per generare una firma o per accedere e convalidare le firme esistenti nel pacchetto.

Ereditarietà

L'interfaccia IOpcDigitalSignatureManager eredita dall'interfaccia IUnknown . IOpcDigitalSignatureManager include anche questi tipi di membri:

Metodi

L'interfaccia IOpcDigitalSignatureManager include questi metodi.


IOpcDigitalSignatureManager::CreateSigningOptions Crea un puntatore all'interfaccia IOpcSigningOptions.
IOpcDigitalSignatureManager::GetSignatureEnumerator Ottiene un enumeratore di puntatori all'interfaccia IOpcDigitalSignature, che rappresentano le firme del pacchetto.
IOpcDigitalSignatureManager::GetSignatureOriginPartName Ottiene un puntatore all'interfaccia IOpcPartUri che rappresenta il nome della parte Digital Signature Origin.
IOpcDigitalSignatureManager::RemoveSignature Rimuove dal pacchetto una parte di firma specificata che archivia il markup della firma.
IOpcDigitalSignatureManager::ReplaceSignatureXml Sostituisce il markup di firma esistente archiviato in una parte di firma specificata.
IOpcDigitalSignatureManager::SetSignatureOriginPartName Imposta il nome della parte Digital Signature Origin sul nome rappresentato da un puntatore all'interfaccia IOpcPartUri specificato.
IOpcDigitalSignatureManager::Sign Firma il pacchetto generando una firma usando il certificato e il puntatore all'interfaccia IOpcSigningOptions specificati.
IOpcDigitalSignatureManager::Validate Convalida una firma del pacchetto specificata usando un certificato specificato.

Commenti

Prima di chiamare il metodo Sign per generare una firma, è necessario chiamare i metodi IOpcSigningOptions::SetDefaultDigestMethod e IOpcSigningOptions::SetSignatureMethod .

Per creare un puntatore all'interfaccia IOpcDigitalSignatureManager , chiamare il metodo IOpcFactory::CreateDigitalSignatureManager .

Importante Se il pacchetto viene modificato durante l'esecuzione del metodo Sign , il metodo potrebbe non riuscire o generare una firma incoerente. Per evitare il danneggiamento del pacchetto, usare le API per salvare il pacchetto prima di chiamare Sign. Per informazioni su come salvare un pacchetto, vedere Salvataggio di un pacchetto.

Il metodo Validate verifica che la firma specificata (entità firmate e markup della firma) non sia stata modificata dopo la generazione della firma, ma non convalida l'identità del firmatario.

Importante Il chiamante deve convalidare l'identità del firmatario.

Thread safety

I pacchetti degli oggetti non sono thread-safe.

IOpcSigningOptions Per altre informazioni, vedere la Introduzione con l'API per la creazione di pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msopc.h