IXpsSignatureRequest::GetIntent-Methode (xpsdigitalsignature.h)
Legt die Zeichenfolge fest, die die Absicht oder Bedeutung der Signatur beschreibt.
Syntax
HRESULT GetIntent(
[out, retval] LPWSTR *intent
);
Parameter
[out, retval] intent
Die Vereinbarung zur Signaturabsicht, für die der Unterzeichner unterzeichnet.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Rückgabewerte, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS Digital Signature API Errors and XPS Document Errors .
Rückgabecode | Beschreibung |
---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Intent ist NULL. |
|
Die Schnittstelle ist nicht mit dem Signatur-Manager verbunden. |
Hinweise
Die Signaturabsichtszeichenfolge beschreibt, was die Signatur für den Signierer bedeutet. Für die Signaturabsichtszeichenfolge "I have read and agree with the contents of this document" bedeutet das Vorhandensein einer digitalen Signatur, dass der Unterzeichner den Inhalt des Dokuments gelesen hat und damit einverstanden ist.
Diese Methode ordnet den Arbeitsspeicher zu, der von der Zeichenfolge verwendet wird, die in der Absicht zurückgegeben wird. Wenn die Absicht nicht NULL ist, verwenden Sie die CoTaskMemFree-Funktion , um den Arbeitsspeicher freizugeben.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | xpsdigitalsignature.h |