IOpcSignatureReference::GetId-Methode (msopc.h)

Artikel
03/06/2024

Ruft den Bezeichner für den Verweis ab.

Syntax

HRESULT GetId(
  [out, retval] LPWSTR *referenceId
);

Parameter

[out, retval] referenceId

Ein Bezeichner für den Verweis.

Wenn der Bezeichner nicht festgelegt ist, ist referenceId 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 referenceId-Parameter ist NULL.

Hinweise

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

Die Angabe eines Bezeichners für einen Verweis ist optional. Bei Verwendung wird der Bezeichner als optionales Id-Attribut eines Reference-Elements im Signaturmarkup serialisiert.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie in der Erste Schritte mit der Paketerstellungs-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