ICertProperty::SetValueOnCertificate-Methode (certenroll.h)

Artikel
08/22/2023

Die SetValueOnCertificate-Methode ordnet einem vorhandenen Zertifikat einen Eigenschaftswert zu.

Syntax

HRESULT SetValueOnCertificate(
  [in] VARIANT_BOOL MachineContext,
  [in] EncodingType Encoding,
  [in] BSTR         strCertificate
);

Parameter

[in] MachineContext

Ein VARIANT_BOOL Wert, der angibt, ob der Zertifikatspeicher für den lokalen Computer oder den aktuellen Benutzer bestimmt ist. Geben Sie VARIANT_TRUE für den Computer und VARIANT_FALSE für den Benutzer an.

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf die durch den strCertificate-Parameter identifizierte Zertifikatzeichenfolge angewendet wird.

[in] strCertificate

Eine BSTR-Variable , die das DER-codierte Zertifikat enthält.

Ab Windows 7 und Windows Server 2008 R2 können Sie anstelle eines codierten Zertifikats einen Fingerabdruck oder eine Seriennummer angeben. Dadurch durchsucht die Funktion die entsprechenden lokalen Speicher nach dem übereinstimmenden Zertifikat. Berücksichtigen Sie dabei Folgendes:

Der BSTR muss eine gerade Anzahl von Hexadezimalstellen sein.
Leerzeichen zwischen Hexadezimalpaaren werden ignoriert.
Der Encoding-Parameter muss auf XCN_CRYPT_STRING_HEXRAW festgelegt werden.
Der MachineContext-Parameter bestimmt, ob der Benutzer oder computer gespeichert oder beides durchsucht wird.
Wenn ein privater Schlüssel benötigt wird, werden nur die persönlichen Speicher und die Anforderungsspeicher durchsucht.
Wenn kein privater Schlüssel benötigt wird, werden auch die Stamm- und Zwischenspeicher der Zertifizierungsstellen durchsucht.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode/-wert	BESCHREIBUNG
CRYPT_E_NOT_FOUND	Das Zertifikat konnte nicht gefunden werden.
CRYPT_E_UNEXPECTED_MSG_TYPE	Das Zertifikat wurde gefunden, aber der private Schlüssel konnte nicht geladen werden.

Hinweise

Rufen Sie die InitializeDecode-Methode oder die InitializeFromCertificate-Methode auf, um einen Eigenschaftswert zu erstellen. Bevor Sie beide Methoden aufrufen, müssen Sie zuerst die PropertyId-Eigenschaft festlegen, um anzugeben, welcher Eigenschaftswert initialisiert werden soll.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h
DLL	CertEnroll.dll

Weitere Informationen

ICertProperties

ICertProperty

Freigeben über