Metodo IX509CertificateRequestPkcs10::get_KeyContainerNamePrefix (certenroll.h)

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 get_KeyContainerNamePrefix(
  BSTR *pValue
);

Parametri

pValue

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:

• InitializeDecode
• InitializeFromCertificate
• InitializeFromPrivateKey
• InitializeFromPublicKey
• InitializeFromTemplateName

Requisiti

Vedi anche

IX509CertificateRequestPkcs10