Interfaccia IXpsSignatureManager (xpsdigitalsignature.h)

Articolo
12/22/2023

Gestisce le firme digitali e le richieste di firma digitale di un documento XPS.

Ereditarietà

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

Metodi

L'interfaccia IXpsSignatureManager include questi metodi.


IXpsSignatureManager::AddSignatureBlock Crea una nuova interfaccia IXpsSignatureBlock e la aggiunge alla raccolta di blocchi di firma.
IXpsSignatureManager::CreateSigningOptions Crea una nuova interfaccia IXpsSigningOptions.
IXpsSignatureManager::GetSignatureBlocks Ottiene un puntatore a un'interfaccia IXpsSignatureBlockCollection contenente una raccolta di blocchi di firma.
IXpsSignatureManager::GetSignatureOriginPartName Ottiene il nome della parte di origine della firma.
IXpsSignatureManager::GetSignatures Ottiene un puntatore a un'interfaccia IXpsSignatureCollection contenente una raccolta di firme digitali XPS.
IXpsSignatureManager::LoadPackageFile Carica un pacchetto XPS esistente da un file nel gestore delle firme digitali.
IXpsSignatureManager::LoadPackageStream Carica un pacchetto XPS da un flusso nel gestore delle firme digitali.
IXpsSignatureManager::SavePackageToFile Salva il pacchetto XPS in un file.
IXpsSignatureManager::SavePackageToStream Salva il pacchetto XPS scrivendolo in un flusso.
IXpsSignatureManager::SetSignatureOriginPartName Imposta il nome della parte di origine della firma.
IXpsSignatureManager::Sign Firma il contenuto di un pacchetto XPS come specificato dalle opzioni di firma e restituisce la firma digitale risultante.

Commenti

Per inizializzare il gestore delle firme da usare con un documento XPS, creare un'istanza di un'interfaccia IXpsSignatureManager chiamando CoCreateInstance come illustrato nell'esempio 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.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	xpsdigitalsignature.h

Vedi anche

Cocreateinstance

Interfacce

XML Paper Specification

Condividi tramite