IXpsSignature::GetSignatureId-Methode (xpsdigitalsignature.h)

Artikel
03/05/2024

Ruft den Wert des Id-Attributs des Signature-Elements ab.

Syntax

HRESULT GetSignatureId(
  [out, retval] LPWSTR *sigId
);

Parameter

[out, retval] sigId

Der Wert des Id-Attributs des Signature-Elements . Wenn das Id-Attribut nicht vorhanden ist, wird ein NULL-Zeiger zurückgegeben.

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	sigId ist NULL.
E_UNEXPECTED	Die Schnittstelle ist nicht mit dem Signatur-Manager verbunden.

Hinweise

Diese Methode weist den Arbeitsspeicher zu, der von der Zeichenfolge verwendet wird, die in sigId zurückgegeben wird. Wenn sigId nicht NULL ist, verwenden Sie die CoTaskMemFree-Funktion , um den Arbeitsspeicher freizugeben.

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