Metodo IX509CertificateRequestPkcs10::p ut_KeyContainerNamePrefix (certenroll.h)

  • Articolo

La proprietà KeyContainerNamePrefix specifica o recupera un prefisso usato per creare il nome del contenitore per una nuova chiave privata.

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT put_KeyContainerNamePrefix(
  BSTR Value
);

Parametri

Value

Valore restituito

nessuno

Osservazioni

Ogni provider di servizi di crittografia CryptoAPI o API di crittografia: il provider di chiavi CNG (Next Generation) gestisce un contenitore di chiavi per la chiave privata. Per recuperare il nome di un contenitore di chiavi per una chiave esistente, utilizzare la proprietà ContainerName dell'oggetto IX509PrivateKey .

Un prefisso può contenere qualsiasi stringa limitata alla lunghezza massima del nome del contenitore della chiave e ai caratteri del nome del contenitore legali. Ad esempio, se non si chiama la proprietà ContainerName per specificare un nome del contenitore di chiavi, ne viene creato automaticamente uno al momento della creazione della chiave privata e il prefisso al nome del contenitore sarà la stringa "lp". Per un altro esempio, se si sta creando un test harness e si vuole distinguere i contenitori di chiavi in base ai programmi che li hanno generati, è possibile usare il nome del file eseguibile come prefisso.

È necessario impostare questa proprietà prima di chiamare il metodo Encode ed è necessario inizializzare l'oggetto IX509CertificateRequestPkcs10 prima di chiamare questa proprietà. Per altre informazioni, vedere uno dei metodi seguenti:

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certenroll.h
DLL CertEnroll.dll

Vedi anche

IX509CertificateRequestPkcs10