Método IX509PrivateKey::get_ProviderType (certenroll.h)

  • Artigo

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 get_ProviderType(
  X509ProviderType *pValue
);

Parâmetros

pValue

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:

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