Interface IXpsSignatureManager (xpsdigitalsignature.h)

Article
12/22/2023

Gère les signatures numériques et les demandes de signature numérique d’un document XPS.

Héritage

L’interface IXpsSignatureManager hérite de l’interface IUnknown. IXpsSignatureManager a également les types de membres suivants :

Méthodes

L’interface IXpsSignatureManager utilise ces méthodes.


IXpsSignatureManager ::AddSignatureBlock Crée une interface IXpsSignatureBlock et l’ajoute à la collection de blocs de signature.
IXpsSignatureManager ::CreateSigningOptions Crée une interface IXpsSigningOptions.
IXpsSignatureManager ::GetSignatureBlocks Obtient un pointeur vers une interface IXpsSignatureBlockCollection qui contient une collection de blocs de signature.
IXpsSignatureManager ::GetSignatureOriginPartName Obtient le nom du composant d’origine de la signature.
IXpsSignatureManager ::GetSignatures Obtient un pointeur vers une interface IXpsSignatureCollection qui contient une collection de signatures numériques XPS.
IXpsSignatureManager ::LoadPackageFile Charge un package XPS existant à partir d’un fichier dans le gestionnaire de signatures numériques.
IXpsSignatureManager ::LoadPackageStream Charge un package XPS à partir d’un flux dans le gestionnaire de signatures numériques.
IXpsSignatureManager ::SavePackageToFile Enregistre le package XPS dans un fichier.
IXpsSignatureManager ::SavePackageToStream Enregistre le package XPS en l’écrivant dans un flux.
IXpsSignatureManager ::SetSignatureOriginPartName Définit le nom du composant d’origine de la signature.
IXpsSignatureManager ::Sign Signe le contenu d’un package XPS comme spécifié par les options de signature et retourne la signature numérique résultante.

Remarques

Pour initialiser le gestionnaire de signatures à utiliser avec un document XPS, instanciez une interface IXpsSignatureManager en appelant CoCreateInstance , comme illustré dans l’exemple suivant.


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’interface instanciée par CoCreateInstance ne peut être utilisée que par un seul document XPS, qui doit être chargé en appelant LoadPackageFile ou LoadPackageStream avant d’appeler toute autre méthode.

Une fois l’interface IXpsSignatureManager instanciée et un document XPS chargé, le gestionnaire de signatures est prêt à être utilisé.

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xpsdigitalsignature.h

Voir aussi

CoCreateInstance

Interfaces

XML Paper Specification

Partager via