Condividi tramite


Metodo IOpcFactory::CreateDigitalSignatureManager (msopc.h)

Crea un oggetto gestione firme digitali per un oggetto package.

Sintassi

HRESULT CreateDigitalSignatureManager(
  [in]          IOpcPackage                 *package,
  [out, retval] IOpcDigitalSignatureManager **signatureManager
);

Parametri

[in] package

Puntatore all'interfaccia IOpcPackage dell'oggetto package da associare all'oggetto gestione firme digitali.

[out, retval] signatureManager

Puntatore all'interfaccia IOpcDigitalSignatureManager dell'oggetto gestione firme digitali creato per l'uso con l'oggetto package.

Un oggetto gestione firme digitali fornisce l'accesso alle interfacce e ai metodi di firma digitale dell'API packaging. Questi possono essere usati per firmare il pacchetto rappresentato dall'oggetto pacchetto o per convalidare le firme in un pacchetto già firmato.

Valore restituito

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

Codice/valore restituito Descrizione
S_OK
Il metodo è riuscito.
E_NOTIMPL
Questo metodo non viene implementato per questa versione di Windows.
OPC_E_DS_DUPLICATE_SIGNATURE_ORIGIN_RELATIONSHIP
0x8051001B
Esiste più di una relazione del tipo di relazione di origine della firma digitale, ma è consentita una sola relazione.

Per altre informazioni su questo tipo di relazione, vedere OPC.

OPC_E_DS_INVALID_SIGNATURE_ORIGIN_RELATIONSHIP
0x8051001C
Una relazione di pacchetto dell'origine della firma digitale di tipo è destinata a una posizione esterna al pacchetto. Le parti origine firma digitale devono trovarsi internamente.

Per altre informazioni su questo tipo di relazione, vedere OPC.

OPC_E_DS_MISSING_SIGNATURE_ORIGIN_PART
0x8051001F
È stata trovata una relazione di origine della firma digitale di tipo, ma la parte Digital Signature Origin stessa non era.

Per altre informazioni su questo tipo di relazione, vedere OPC.

Commenti

Se un pacchetto viene modificato durante l'uso delle interfacce di firma digitale per la creazione di pacchetti per firmare il pacchetto, la firma potrebbe non riuscire o comportare una firma o un pacchetto incoerente.

Supporto nelle versioni precedenti di Windows

Questo metodo non è supportato nelle versioni di Windows precedenti a Windows 7. Per altre informazioni, vedere Introduzione con l'API Creazione pacchetti e l'aggiornamento della piattaforma per Windows Vista.

Thread safety

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

Per altre informazioni, vedere l'Introduzione con l'API Creazione 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

Panoramica delle firme digitali

ECMA-376 OpenXML

Risorse esterne

Introduzione con l'API Creazione pacchetti

IOpcFactory

Esempio di firma del bundle musicale

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 di creazione di pacchetti

Errori di creazione pacchetti

Aggiornamento della piattaforma per Windows Vista

Riferimento