Share via

IX509CertificateRequestPkcs10::p ut_KeyContainerNamePrefix-Methode (certenroll.h)

  • Artikel

Die KeyContainerNamePrefix-Eigenschaft gibt ein Präfix an oder ruft es ab, das zum Erstellen des Containernamens für einen neuen privaten Schlüssel verwendet wird.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_KeyContainerNamePrefix(
  BSTR Value
);

Parameter

Value

Rückgabewert

Keine

Bemerkungen

Jeder CryptoAPI-Kryptografiedienstanbieter oder CNG-Schlüsselanbieter (Cryptography API: Next Generation) verwaltet einen Schlüsselcontainer für den privaten Schlüssel. Um den Namen eines Schlüsselcontainers für einen vorhandenen Schlüssel abzurufen, verwenden Sie die ContainerName-Eigenschaft des IX509PrivateKey-Objekts .

Ein Präfix kann eine beliebige Zeichenfolge enthalten, die auf die maximale Länge des Schlüsselcontainernamens und auf die Zeichen für den containerrechtlichen Containernamen beschränkt ist. Wenn Sie beispielsweise die ContainerName-Eigenschaft nicht aufrufen, um einen Schlüsselcontainernamen anzugeben, wird automatisch ein Containername erstellt, wenn der private Schlüssel erstellt wird, und das Präfix für den Containernamen lautet die Zeichenfolge "lp". Ein weiteres Beispiel: Wenn Sie eine Testumgebung erstellen und Schlüsselcontainer anhand der Programme unterscheiden möchten, die sie generiert haben, können Sie den Namen der ausführbaren Datei als Präfix verwenden.

Sie müssen diese Eigenschaft festlegen, bevor Sie die Encode-Methode aufrufen, und Sie müssen das IX509CertificateRequestPkcs10-Objekt initialisieren, bevor Sie diese Eigenschaft aufrufen. Weitere Informationen finden Sie unter einer der folgenden Methoden:

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

IX509CertificateRequestPkcs10