Méthode IXpsSignatureRequest ::GetIntent (xpsdigitalsignature.h)
Définit la chaîne qui décrit l’intention ou la signification de la signature.
Syntaxe
HRESULT GetIntent(
[out, retval] LPWSTR *intent
);
Paramètres
[out, retval] intent
Accord d’intention de signature contre lequel le signataire signe.
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 |
|
intention est NULL. |
|
L’interface n’est pas connectée au gestionnaire de signatures. |
Remarques
La chaîne d’intention de signature décrit ce que signifie la signature pour le signataire. Par exemple, pour la chaîne d’intention de signature « J’ai lu et accepté le contenu de ce document », la présence d’une signature numérique signifie que le signataire a lu et est d’accord avec le contenu du document.
Cette méthode alloue la mémoire utilisée par la chaîne retournée dans l’intention. Si l’intention n’est pas NULL, utilisez la fonction CoTaskMemFree pour libérer la mémoire.
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 |