Méthode IXpsSignatureRequest ::GetRequestId (xpsdigitalsignature.h)
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 |
|
requestId a la valeur NULL. |
|
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 |