Méthode IXpsSignatureBlock ::CreateRequest (xpsdigitalsignature.h)
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 |
|
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 |