IXpsSignatureRequest::GetRequestId-Methode (xpsdigitalsignature.h)
Ruft den eindeutigen Bezeichner der Signaturanforderung ab.
Syntax
HRESULT GetRequestId(
[out, retval] LPWSTR *requestId
);
Parameter
[out, retval] requestId
Der eindeutige Bezeichner der Signaturanforderung.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Rückgabewerte, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS Digital Signature-API-Fehler und XPS-Dokumentfehler.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
requestId ist NULL. |
|
Die Schnittstelle ist nicht mit dem Signatur-Manager verbunden. |
Hinweise
Diese Methode ordnet den Arbeitsspeicher zu, der von der Zeichenfolge verwendet wird, die in requestId zurückgegeben wird. Wenn requestId nicht NULL ist, verwenden Sie die CoTaskMemFree-Funktion , um den Arbeitsspeicher freizugeben.
Der parameter requestId empfängt den Wert des SpotID-Attributs des SignatureDefinition-Elements . Das SpotID-Attribut ist erforderlich und sollte dem Format xs:ID (XML ID) entsprechen. Vorhandene SignatureDefinitions-Teile werden jedoch nicht auf Die Einhaltung des empfohlenen Formats überprüft. Einige XPS-Dokumente, die von Windows Presentation Foundation (WPF)-Anwendungen erstellt wurden, weisen möglicherweise eine ID auf, die mit einer Ziffer beginnt.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |