Freigeben über


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
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_POINTER
Intent ist NULL.
E_UNEXPECTED
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

Weitere Informationen

IXpsSignatureManager

IXpsSignatureRequest

XML Paper Specification

FEHLER BEI DER XPS-API für die digitale Signatur

XPS-Dokumentfehler