Metodo PrivateKey.Open

Articolo
06/13/2023

[Il metodo Open è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Usare invece la proprietà X509Certificate2.PrivateKey nello spazio dei nomi System.Security.Cryptography.X509Certificates .

Il metodo Open accede a un contenitore di chiavi esistente. Questo metodo associa il contenitore di chiavi al certificato che corrisponde alla chiave privata aggiungendo la proprietà CERT_KEY_PROV_INFO_PROP_ID usando le informazioni specificate.

Sintassi

PrivateKey.Open( _
  ByVal ContainerName, _
  [ ByVal ProviderName ], _
  [ ByVal ProviderType ], _
  [ ByVal KeySpec ], _
  [ ByVal StoreLocation ], _
  [ ByVal bCheckExistence ] _
)

Parametri

ContainerName [in]

Stringa contenente il nome del contenitore di chiavi.

ProviderName [in, facoltativo]

Stringa contenente il nome del provider. Il valore predefinito è CAPICOM_PROV_MS_ENHANCED_PROV. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
CAPICOM_PROV_MS_DEF_PROV	Provider di crittografia di base Microsoft.
CAPICOM_PROV_MS_ENHANCED_PROV	Provider di crittografia avanzato microsoft.
CAPICOM_PROV_MS_STRONG_PROV	Provider di crittografia sicuro di Microsoft.
CAPICOM_PROV_MS_DEF_RSA_SIG_PROV	Provider di crittografia della firma Microsoft RSA.
CAPICOM_PROV_MS_DEF_RSA_SCHANNEL_PROV	Provider di crittografia Microsoft RSA Schannel.
CAPICOM_PROV_MS_DEF_DSS_PROV	Provider di crittografia DSS di base Microsoft.
CAPICOM_PROV_MS_DEF_DSS_DH_PROV	Microsoft base DSS e Diffie-Hellman provider di crittografia.
CAPICOM_PROV_MS_ENH_DSS_DH_PROV	Microsoft ha migliorato DSS e Diffie-Hellman provider di crittografia.
CAPICOM_PROV_MS_DEF_DH_SCHANNEL_PROV	Provider di crittografia Schannel di Microsoft DH.
CAPICOM_PROV_MS_SCARD_PROV	Provider di crittografia della smart card di base Microsoft.
CAPICOM_PROV_MS_ENH_RSA_AES_PROV	Provider di crittografia RSA e AES avanzato da Microsoft.

ProviderType [in, facoltativo]

Valore dell'enumerazione CAPICOM_PROV_TYPE che specifica un tipo di provider. Il valore predefinito è CAPICOM_PROV_RSA_FULL. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
CAPICOM_PROV_RSA_FULL	Provider di servizi di crittografiaRSA completo( CSP). Questo tipo di provider supporta sia le firme digitali che la crittografia dei dati.
CAPICOM_PROV_RSA_SIG	Subset del provider di servizi di configurazione RSA che supporta solo le funzioni e gli algoritmi necessari per hash e firme digitali.
CAPICOM_PROV_DSS	Provider di servizi di configurazione DSS (Digital Signature Standard ). Questo tipo di provider supporta solo hash e firme digitali. DSS usa l'algoritmo DSA ( Digital Signature Algorithm ).
CAPICOM_PROV_FORTEZZA	CSP che contiene i protocolli crittografici e gli algoritmi di proprietà del National Institute of Standards and Technology (NIST).
CAPICOM_PROV_MS_EXCHANGE	CSP che supporta l'applicazione di posta di Microsoft Exchange e altre applicazioni compatibili con Microsoft Mail.
CAPICOM_PROV_SSL	Provider di servizi di configurazione che supporta il protocollo SSL (Secure Sockets Layer ).
CAPICOM_PROV_RSA_SCHANNEL	Provider di servizi di configurazione che supporta i protocolli RSA e Schannel .
CAPICOM_PROV_DSS_DH	Provider di servizi di configurazione che supporta protocolli DSS e Diffie-Hellman .
CAPICOM_PROV_EC_ECDSA_SIG	CSP che supporta le funzioni e gli algoritmi ECDSA (Elliptic Curve Digital Signature Algorithm) necessari per le firme digitali.
CAPICOM_PROV_EC_ECNRA_SIG	CSP che supporta le funzioni e gli algoritmi ECNRA (Elliptic Curve Nyberg-Rueppel Analog) necessari per le firme digitali.
CAPICOM_PROV_EC_ECDSA_FULL	Provider di servizi di configurazione che supporta l'ECDSA completo.
CAPICOM_PROV_EC_ECNRA_FULL	CSP che supporta l'ECNRA completo.
CAPICOM_PROV_DH_SCHANNEL	CSP che supporta entrambi i protocolli Diffie-Hellman e Schannel .
CAPICOM_PROV_SPYRUS_LYNKS	CSP che supporta il dispositivo SPYRUS LYNKS Card.
CAPICOM_PROV_RNG	Provider di servizi di configurazione che gestisce la generazione di numeri casuali.
CAPICOM_PROV_INTEL_SEC	Provider di servizi di configurazione che fornisce la sicurezza Intel.
CAPICOM_PROV_REPLACE_OWF	Provider di servizi di configurazione che supporta la sostituzione del modo in cui vengono generati formati unidirezionale dalle password.
CAPICOM_PROV_RSA_AES	Provider di servizi di configurazione che supporta sia le firme digitali che la crittografia dei dati usando l'algoritmo AES (Advanced Encryption Standard).

KeySpec [in, facoltativo]

Valore dell'enumerazione CAPICOM_KEY_SPEC che specifica il tipo di chiave privata. Il valore predefinito è CAPICOM_KEY_SPEC_SIGNATURE. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
CAPICOM_KEY_SPEC_KEYEXCHANGE	La chiave può essere usata per la crittografia e la firma.
CAPICOM_KEY_SPEC_SIGNATURE	La chiave può essere usata solo per la firma.

StoreLocation [in, facoltativo]

Valore dell'enumerazione CAPICOM_STORE_LOCATION che specifica la posizione dell'archivio in cui risiede la chiave. Il valore predefinito è CAPICOM_CURRENT_USER_STORE. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
CAPICOM_MEMORY_STORE	L'archivio è un archivio di memoria. Le modifiche apportate al contenuto dell'archivio non vengono mantenute.
CAPICOM_LOCAL_MACHINE_STORE	L'archivio è un archivio computer locale. Gli archivi del computer locale possono essere archivi di lettura/scrittura solo se l'utente dispone di autorizzazioni di lettura/scrittura. Se l'utente dispone di autorizzazioni di lettura/scrittura e se l'archivio viene aperto in lettura/scrittura, le modifiche apportate al contenuto dell'archivio vengono rese persistenti.
CAPICOM_CURRENT_USER_STORE	L'archivio è un archivio utenti corrente. Un archivio utente corrente può essere un archivio di lettura/scrittura. In caso affermativo, le modifiche apportate al contenuto dell'archivio vengono mantenute.
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	L'archivio è un archivio Active Directory. Gli archivi di Active Directory possono essere aperti solo in modalità di sola lettura. I certificati non possono essere aggiunti o rimossi dagli archivi di Active Directory.
CAPICOM_SMART_CARD_USER_STORE	Lo store è il gruppo di smart card presenti. Introdotta in CAPICOM 2.0.

bCheckExistence [in, facoltativo]

Valore booleano che indica se CAPICOM tenterà di accedere alla chiave. Se True, CAPICOM tenta di accedere alla chiave. Se la chiave è protetta dall'utente o in una smart card o in un altro dispositivo, potrebbe essere generata una finestra di dialogo. Il valore predefinito è False.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Questo metodo restituisce CAPICOM_E_NOT_ALLOWED quando viene creato uno script da un'applicazione basata sul Web.

Requisiti

Requisito	Valore
Componente ridistribuibile	CAPICOM 2.0 o versione successiva in Windows Server 2003 e Windows XP
DLL	Capicom.dll

Vedi anche

PrivateKey
Certificate.HasPrivateKey