Share via


Metodo IX509PrivateKey::p ut_ProviderType (certenroll.h)

La proprietà ProviderType specifica o recupera il tipo di provider di crittografia associato alla chiave privata. Questa proprietà è abilitata sia per l'input che per l'output.

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT put_ProviderType(
  X509ProviderType Value
);

Parametri

Value

Valore restituito

nessuno

Osservazioni

È possibile utilizzare questa proprietà per forzare l'uso del provider predefinito per un determinato tipo di provider. Ad esempio, per utilizzare il provider di PROV_RSA_SCHANNEL, impostare questa proprietà sul valore di enumerazione X509ProviderTypeXCN_PROV_RSA_SCHANNEL e non specificare un valore per la proprietà ProviderName.

L'impostazione di questa proprietà imposta automaticamente le proprietà seguenti in modo che siano coerenti con il valore ProviderType specificato:

Queste proprietà vengono impostate nel modo seguente:
  • Se providerType è impostato su XCN_PROV_NONE:
    • La proprietà LegacyCsp è impostata su VARIANT_FALSE.
    • La proprietà KeySpec è impostata su XCN_AT_NONE.
  • Se providerType non è impostato su XCN_PROV_NONE:
    • La proprietà LegacyCsp è impostata su VARIANT_TRUE.
    • La proprietà KeySpec è impostata su XCN_AT_SIGNATURE se il valore corrente è XCN_AT_NONE.
Poiché un ProviderName specificato in precedenza non è interessato dall'impostazione della proprietà ProviderType , l'impostazione di un ProviderType incoerente con la proprietà ProviderName genererà un comportamento indefinito, probabilmente un errore durante la creazione o l'apertura di una chiave privata. È consigliabile impostare la proprietà ProviderType solo quando si tenta di forzare l'uso del provider predefinito per il tipo specificato, come illustrato in precedenza.

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