Interfaccia IOpcSigningOptions (msopc.h)

Articolo
08/25/2023

Fornisce metodi per impostare e accedere alle informazioni necessarie per generare una firma.

Ereditarietà

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

Metodi

L'interfaccia IOpcSigningOptions include questi metodi.


IOpcSigningOptions::GetCertificateEmbeddingOption Ottiene un valore che specifica il percorso di archiviazione nel pacchetto del certificato da utilizzare per la firma.
IOpcSigningOptions::GetCertificateSet Ottiene un puntatore dell'interfaccia IOpcCertificateSet.
IOpcSigningOptions::GetCustomObjectSet Ottiene un'interfaccia IOpcSignatureCustomObjectSet.
IOpcSigningOptions::GetCustomReferenceSet Ottiene un puntatore dell'interfaccia IOpcSignatureReferenceSet.
IOpcSigningOptions::GetDefaultDigestMethod Ottiene il metodo digest predefinito che verrà usato per calcolare i valori di digest per gli oggetti da firmare.
IOpcSigningOptions::GetSignatureId Ottiene il valore dell'attributo Id dall'elemento Signature.
IOpcSigningOptions::GetSignatureMethod Ottiene il metodo di firma da usare per calcolare e crittografare il valore hash dell'elemento SignedInfo, che verrà serializzato come elemento SignatureValue della firma.
IOpcSigningOptions::GetSignaturePartName Ottiene il nome della parte della parte di firma in cui verrà archiviato il markup della firma.
IOpcSigningOptions::GetSignaturePartReferenceSet Ottiene un'interfaccia IOpcSignaturePartReferenceSet.
IOpcSigningOptions::GetSignatureRelationshipReferenceSet Ottiene un puntatore dell'interfaccia IOpcSignatureRelationshipReferenceSet.
IOpcSigningOptions::GetTimeFormat Ottiene il formato della stringa recuperata dal metodo IOpcDigitalSignature::GetSigningTime.
IOpcSigningOptions::SetCertificateEmbeddingOption Impostare il percorso di archiviazione del certificato da usare per la firma.
IOpcSigningOptions::SetDefaultDigestMethod Imposta il metodo digest predefinito che verrà usato per calcolare i valori del digest per gli oggetti da firmare.
IOpcSigningOptions::SetSignatureId Imposta il valore dell'attributo Id dell'elemento Signature. (IOpcSigningOptions.SetSignatureId)
IOpcSigningOptions::SetSignatureMethod Imposta il metodo di firma da usare per calcolare e crittografare il valore hash dell'elemento SignedInfo, che verrà contenuto nell'elemento SignatureValue della firma.
IOpcSigningOptions::SetSignaturePartName Imposta il nome della parte della parte di firma in cui verrà archiviato il markup della firma.
IOpcSigningOptions::SetTimeFormat Imposta il formato della stringa recuperata dal metodo IOpcDigitalSignature::GetSigningTime.

Commenti

Per generare una firma, chiamare il metodo IOpcDigitalSignatureManager::Sign con il valore del parametro signOptions impostato su un puntatore dell'interfaccia IOpcSigningOptions .

Per creare un puntatore dell'interfaccia IOpcSigningOptions , chiamare il metodo IOpcDigitalSignatureManager::CreateSigningOptions .

Il chiamante deve impostare un valore predefinito per il metodo digest e il metodo di firma prima di generare una firma. Per impostare un metodo digest predefinito, chiamare il metodo SetDefaultDigestMethod . Per impostare un metodo di firma, chiamare il metodo SetSignatureMethod .

Per ottenere un puntatore dell'interfaccia IOpcSignatureCustomObjectSet , chiamare il metodo GetCustomObjectSet . I puntatori di interfaccia nel set rappresentano elementi Object specifici dell'applicazione.

Per ottenere un puntatore dell'interfaccia IOpcSignatureReferenceSet , chiamare il metodo GetCustomReferenceSet . I puntatori di interfaccia nel set rappresentano riferimenti agli elementi Object specifici dell'applicazione o ai relativi elementi figlio che verranno firmati quando viene generata la firma.

Il percorso predefinito del certificato è OPC_CERTIFICATE_IN_CERTIFICATE_PART. Per modificare questo valore, chiamare il metodo SetCertificateEmbeddingOption .

Il formato predefinito della stringa di tempo di firma è OPC_SIGNATURE_TIME_FORMAT_MILLISECONDS. Per modificare il formato della stringa di tempo di firma, chiamare il metodo SetTimeFormat .

Thread safety

Gli oggetti di creazione dei pacchetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API Creazione pacchetti.

Requisiti


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