IOpcDigitalSignature::GetSignatureId-Methode (msopc.h)

Artikel
03/06/2024

Ruft den Wert des Id-Attributs aus dem Signature-Element des Signaturmarkups ab.

Syntax

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

Parameter

[out, retval] signatureId

Ein Zeiger auf den Id-Attributwert des Signaturmarkierungselements Signature .

Wenn das Signature-Element keinen Id-Attributwert aufweist, ist signatureId die leere Zeichenfolge.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Der signatureId-Parameter ist NULL.

Hinweise

Diese Methode ordnet Arbeitsspeicher zu, der von der in signatureId zurückgegebenen Zeichenfolge verwendet wird. Wenn die Methode erfolgreich ist, rufen Sie die CoTaskMemFree-Funktion auf, um den Arbeitsspeicher freizugeben.

Das Id-Attribut des Signature-Elements ist optional. Wenn diese Methode nicht aufgerufen wird, verfügt das Signature-Element nicht über das Id-Attribut .

Um die Signatur-ID festzulegen, bevor die Signatur generiert wird, rufen Sie die IOpcSigningOptions::SetSignatureId-Methode auf.

Um auf die ID zuzugreifen, bevor die Signatur generiert wird, rufen Sie IOpcSigningOptions::GetSignatureId auf. -Methode.

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	msopc.h