IX509CertificateRequestPkcs10::get_KeyContainerNamePrefix-Methode (certenroll.h)
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 get_KeyContainerNamePrefix(
BSTR *pValue
);
Parameter
pValue
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:
- InitializeDecode
- InitializeFromCertificate
- InitializeFromPrivateKey
- InitializeFromPublicKey
- InitializeFromTemplateName
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 |