IOpcCertificateEnumerator::GetCurrent-Methode (msopc.h)

Artikel
03/04/2024

Ruft die CERT_CONTEXT-Struktur an der aktuellen Position des Enumerators ab.

Syntax

HRESULT GetCurrent(
  [out, retval] const CERT_CONTEXT **certificate
);

Parameter

[out, retval] certificate

Ein Zeiger auf eine CERT_CONTEXT-Struktur . Wenn die Methode erfolgreich ist, rufen Sie die CertFreeCertificateContext-Funktion auf, um den Arbeitsspeicher der Struktur freizugeben.

Rückgabewert

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

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Der partReference-Parameter ist NULL.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	Der Enumerator ist ungültig, da sich der zugrunde liegende Satz geändert hat.
OPC_E_ENUM_INVALID_POSITION 0x80510053	Der Enumerator kann diesen Vorgang nicht von seiner aktuellen Position aus ausführen.
OPC_E_DS_EXTERNAL_SIGNATURE 0x8051001E	Eine Beziehung, deren Ziel ein Signaturteil ist, verfügt über den externen Zielmodus. Signaturteile müssen sich innerhalb des Pakets befinden.
OPC_E_DS_INVALID_CERTIFICATE_RELATIONSHIP 0x8051001D	Eine Beziehung vom Typ digitales Signaturzertifikat verfügt über den externen Zielmodus. Weitere Informationen zu diesem Beziehungstyp finden Sie unter OPC.
OPC_E_DS_INVALID_RELATIONSHIP_TRANSFORM_XML 0x80510021	Ein Transform-Element , das die Verwendung der Beziehungstransformation angibt, und die Auswahlkriterien für die Transformation entsprechen nicht dem im OPC angegebenen Schema.
OPC_E_DS_MISSING_CERTIFICATE_PART 0x80510056	Der Teil, der das Zertifikat enthält und das Ziel einer Beziehung vom Typ digitales Signaturzertifikat ist, ist nicht vorhanden. Weitere Informationen zu diesem Beziehungstyp finden Sie unter OPC.
OPC_E_DS_SIGNATURE_PROPERTY_MISSING_TARGET 0x80510045	Dem SignatureProperty-Element fehlt das erforderliche Target-Attribut .
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	Entweder unterschied sich der Inhaltstyp eines Teils vom erwarteten Inhaltstyp (angegeben in OPC, ECMA-376 Part 2), oder der Teilinhalt entsprach nicht dem Inhaltstyp des Teils.

Hinweise

Wenn das durch die CERT_CONTEXT-Struktur dargestellte Zertifikat beschädigt ist oder kein X.509-Zertifikat ist, gibt diese Methode einen Fehler zurück. Darüber hinaus legt die vom Aufrufer verwendete Signaturrichtlinie fest, ob die Signatur weiterhin überprüft wird. Nachdem diese Art von Fehler zurückgegeben wurde, durchlaufen Aufrufe der MoveNext - oder MovePrevious-Methode weiterhin den Enumerator.

Wenn ein Enumerator erstellt wird, geht die aktuelle Position dem ersten Zeiger des Enumerators voran. Um die aktuelle Position auf den ersten Zeiger festzulegen, rufen Sie die MoveNext-Methode auf, nachdem der Enumerator erstellt wurde.

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