IOpcSigningOptions::GetSignatureId-Methode (msopc.h)

Artikel
02/29/2024

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

Syntax

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

Parameter

[out, retval] signatureId

Ein Zeiger auf den Wert des Id-Attributs oder die leere Zeichenfolge "", wenn keine ID vorhanden ist.

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.

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

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

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

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