Método IX509PrivateKey::p ut_ProviderType (certenroll.h)

A propriedade ProviderType especifica ou recupera o tipo de provedor criptográfico associado à chave privada. Essa propriedade está habilitada para a Web para entrada e saída.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_ProviderType(
  X509ProviderType Value
);

Parâmetros

Value

Valor retornado

Nenhum

Comentários

Você pode usar essa propriedade para forçar o uso do provedor padrão para um determinado tipo de provedor. Por exemplo, para usar o provedor PROV_RSA_SCHANNEL, defina essa propriedade como o valor de enumeração XCN_PROV_RSA_SCHANNEL X509ProviderType e não especifique um valor para a propriedade ProviderName.

Definir essa propriedade define automaticamente as seguintes propriedades como consistentes com o valor ProviderType especificado:

• KeySpec
• LegacyCsp

Essas propriedades são definidas da seguinte maneira:

• Se ProviderType estiver definido como XCN_PROV_NONE:
  • A propriedade LegacyCsp é definida como VARIANT_FALSE.
  • A propriedade KeySpec é definida como XCN_AT_NONE.
• Se ProviderType não estiver definido como XCN_PROV_NONE:
  • A propriedade LegacyCsp é definida como VARIANT_TRUE.
  • A propriedade KeySpec será definida como XCN_AT_SIGNATURE se o valor atual for XCN_AT_NONE.

Como um ProviderName especificado anteriormente não é afetado pela definição da propriedade ProviderType , definir um ProviderType inconsistente com a propriedade ProviderName resultará em um comportamento indefinido, provavelmente uma falha ao criar ou abrir uma chave privada. Recomendamos que você defina a propriedade ProviderType somente ao tentar forçar o uso do provedor padrão para o tipo especificado, conforme discutido acima.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certenroll.h
DLL	CertEnroll.dll

Confira também

IX509PrivateKey