Méthode IXpsSignatureBlock ::CreateRequest (xpsdigitalsignature.h)

Article
12/22/2023

Crée une interface IXpsSignatureRequest et l’ajoute au bloc de signature.

Syntaxe

HRESULT CreateRequest(
  [in]          LPCWSTR              requestId,
  [out, retval] IXpsSignatureRequest **signatureRequest
);

Paramètres

[in] requestId

Chaîne qui identifie de manière unique la nouvelle demande de signature dans le bloc de signature. Pour que la méthode génère une chaîne d’ID, définissez ce paramètre sur NULL.

[out, retval] signatureRequest

Pointeur vers la nouvelle interface IXpsSignatureRequest . Si l’accès à la nouvelle interface de requête n’est pas requis, ce paramètre peut être défini sur NULL.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles du tableau qui suit. Pour les valeurs de retour qui ne sont pas répertoriées dans ce tableau, consultez Erreurs d’API de signature numérique XPS et Erreurs de document XPS.

Code de retour	Description
S_OK	S_OK
E_UNEXPECTED	L’interface n’est pas connectée au gestionnaire de signatures ou requestId a la valeur NULL et une chaîne d’ID unique n’a pas pu être générée.

Remarques

La nouvelle demande de signature doit avoir un ID de demande unique ; deux requêtes peuvent avoir la même chaîne d’ID.

La création d’une nouvelle requête marque le bloc de signature comme sale et génère du contenu pour la partie SignatureDefinitions. Lorsque le package XPS est sérialisé, le nouveau contenu remplace le contenu précédent dans la partie SignatureDefinitions.

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