Méthode IXpsSignatureRequest ::GetRequestId (xpsdigitalsignature.h)

Article
03/13/2024

Obtient l’identificateur unique de la demande de signature.

Syntaxe

HRESULT GetRequestId(
  [out, retval] LPWSTR *requestId
);

Paramètres

[out, retval] requestId

Identificateur unique de la demande de signature.

Valeur retournée

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

Code de retour	Description
S_OK	S_OK
E_POINTER	requestId a la valeur NULL.
E_UNEXPECTED	L’interface n’est pas connectée au gestionnaire de signatures.

Remarques

Cette méthode alloue la mémoire utilisée par la chaîne retournée dans requestId. Si requestId n’a pas la valeur NULL, utilisez la fonction CoTaskMemFree pour libérer la mémoire.

Le paramètre requestId reçoit la valeur de l’attribut SpotID de l’élément SignatureDefinition . L’attribut SpotID est obligatoire et doit suivre le format xs :ID (ID XML) ; toutefois, les parties SignatureDefinitions existantes ne sont pas vérifiées pour vérifier si elles respectent le format recommandé. Certains documents XPS qui ont été produits par des applications Windows Presentation Foundation (WPF) peuvent avoir un ID qui commence par un chiffre.

Configuration requise

Condition requise	Valeur
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