Metodo IX509PrivateKey::Create (certenroll.h)

Il metodo Create crea una chiave privata asimmetrica.

Sintassi

HRESULT Create();

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito Descrizione
HRESULT_FROM_WIN32(ERROR_BUSY)
L'handle CSP non è NULL.
HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)
La chiave esiste già.

Commenti

Se non si impostano le proprietà CspStatus, ProviderName o ProviderType , questo metodo usa il provider predefinito, le dimensioni della chiave e i valori KeySpec durante la creazione della chiave. In una nuova installazione del sistema operativo, ad esempio, Microsoft Enhanced Cryptographic Provider v1.0 è il provider predefinito.

Se non si imposta la proprietà ContainerName , questo metodo genera automaticamente un nome. Il nome generato include un GUID e, se la proprietà ContainerNamePrefix non è impostata, il prefisso "lp-". Se il provider è un provider di smart card, il nome generato non supererà il valore MaxKeyContainerNameLength specificato dal provider. Se il nome generato supera inizialmente questo valore, viene troncato a quaranta caratteri.

Non è possibile impostare le proprietà seguenti dopo aver chiamato i metodi Create o Open . Se si desidera specificarli, è necessario eseguire questa operazione prima di chiamare uno di questi metodi.

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

IX509PrivateKey