Condividi tramite

Inizializzare Signature Manager

  • Articolo

In questo argomento viene descritto come inizializzare il gestore delle firme da utilizzare con un documento XPS.

Prima di usare gli esempi di codice seguenti nel programma, leggere la dichiarazione di non responsabilità in Common Digital Signature Programming Tasks (Attività comuni di programmazione delle firme digitali).

Per usare le funzionalità di Windows 7 dell'API Crypto, definire il simbolo CRYPT_OID_INFO_HAS_EXTRA_FIELDS come indicato di seguito:

#define CRYPT_OID_INFO_HAS_EXTRA_FIELDS

Creare quindi un'istanza di un'interfaccia IXpsSignatureManager chiamando CoCreateInstance, come illustrato nell'esempio di codice seguente.

IXpsSignatureManager    *newInterface;

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsSignatureManager),
    NULL, 
    CLSCTX_INPROC_SERVER,
    __uuidof(IXpsSignatureManager),
    reinterpret_cast<LPVOID*>(&newInterface));

// make sure that you got a pointer 
// to the interface
if (SUCCEEDED(hr)) {
    // Load document into signature manager from file.
    //  xpsDocument is initialized with the file name
    //  of the document to load outside of this example.
    hr = newInterface->LoadPackageFile (xpsDocument);

    // Use newInterface

    // Release interface pointers when finished with them 
    newInterface->Release();
}

L'interfaccia creata da CoCreateInstance può essere usata da un solo documento XPS, che deve essere caricato chiamando LoadPackageFile o LoadPackageStream prima di chiamare qualsiasi altro metodo.

Dopo aver creato un'istanza dell'interfaccia IXpsSignatureManager e aver caricato un documento XPS, il gestore delle firme è pronto per l'uso.

Passaggi successivi

Firmare un documento

Aggiungere una richiesta di firma a un documento XPS

Verificare le firme dei documenti

Usato in questa sezione

Cocreateinstance

IXpsSignatureManager

Ulteriori informazioni

Errori dell'API di firma digitale XPS

Errori del documento XPS

Specifica di carta XML