IX509AttributeClientId::InitializeEncode-Methode (certenroll.h)

  • Artikel

Die InitializeEncode-Methode initialisiert das Attribut anhand von Informationen über den Benutzer, den Clientcomputer und die Anwendung, die die Zertifikatanforderung übermittelt hat.

Syntax

HRESULT InitializeEncode(
  [in]           RequestClientInfoClientId ClientId,
  [in, optional] BSTR                      strMachineDnsName,
  [in, optional] BSTR                      strUserSamName,
  [in, optional] BSTR                      strProcessName
);

Parameter

[in] ClientId

Ein RequestClientInfoClientClientId-Enumerationswert , der den Anwendungstyp identifiziert, der die Anforderung erstellt hat. Beispiele hierfür sind Automatische Registrierungsdienste, Befehlszeilenanforderungstools und benutzerdefinierte Anforderungsanwendungen.

[in, optional] strMachineDnsName

Eine BSTR-Variable , die den DNS-Namen (Domain Name System) des Computers enthält, auf dem die Anforderung erstellt wurde, z. B ComputerName.contoso.com. . Wenn Sie keinen Namen angeben, ruft die Methode die GetComputerNameEx-Funktion auf. Wenn kein Name gefunden werden kann, schlägt die Methode fehl.

[in, optional] strUserSamName

Eine BSTR-Variable , die den SAM-Namen ( Security Accounts Manager ) für den Benutzer im Format Domänenname\Benutzername enthält. Wenn Sie keinen Namen angeben, ruft die Methode die GetUserNameEx-Funktion auf. Wenn kein Name gefunden werden kann, schlägt die Methode fehl.

[in, optional] strProcessName

Eine BSTR-Variable , die den Namen der Anwendung enthält, die die Zertifikatanforderung erstellt hat. Wenn Sie keinen Namen angeben, ruft die Methode die GetCommandLine-Funktion auf und analysiert die Befehlszeile. Wenn kein Name gefunden werden kann, schlägt die Methode fehl.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Der Objektbezeichner (OID) für dieses Attribut ist XCN_OID_REQUEST_CLIENT_INFO (1.3.6.1.4.1.311.21.20). Weitere Informationen finden Sie unter CERTENROLL_OBJECTID. Das Attribut wird als ASN.1-Struktur (Abstract Syntax Notation One) erstellt, die mithilfe von Distinguished Encoding Rules (DER) codiert wird.

Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509AttributeClientId-Objekt verwenden können. Die beiden Methoden ergänzen sich. Mit der InitializeEncode-Methode können Sie eine codierte ASN.1-Struktur aus Rohdaten erstellen, und mit der InitializeDecode-Methode können Sie Rohdaten aus einer codierten ASN.1-Struktur initialisieren. Sie können die folgenden Eigenschaften aufrufen, um die Rohdaten abzurufen:

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

IX509AttributeClientId

InitializeDecode