Método ICspInformation::InitializeFromType (certenroll.h)

O método InitializeFromType inicializa o objeto do provedor criptográfico padrão.

Sintaxe

HRESULT InitializeFromType(
  [in]           X509ProviderType Type,
  [in, optional] IObjectId        *pAlgorithm,
  [in]           VARIANT_BOOL     MachineContext
);

Parâmetros

[in] Type

Um valor de enumeração X509ProviderType que define o tipo de provedor.

• Se você especificar XCN_PROV_NONE e definir o parâmetro pAlgorithm como um valor diferente de NULL, o provedor padrão da API de Criptografia: CNG (Próxima Geração) será usado.
• Se você especificar um valor diferente de XCN_PROV_NONE e definir o parâmetro pAlgorithm como NULL, o CSP (provedor de serviços criptográficos) padrão será usado.

[in, optional] pAlgorithm

Ponteiro para uma interface IObjectId que representa um OID de algoritmo. Esse parâmetro é opcional e pode ser NULL. Para obter mais informações, consulte o parâmetro Type .

[in] MachineContext

Uma variável VARIANT_BOOL que indica se o computador ou o contexto do usuário deve ser usado para determinar o provedor padrão para o tipo de provedor especificado. Especifique VARIANT_TRUE para o computador e VARIANT_FALSE para o usuário.

Valor de retorno

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

Observações

O método InitializeFromType valida o tipo especificado e o salva na propriedade Type , recupera o provedor padrão e define os seguintes valores de propriedade no objeto ICspInformation :

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• LegacyCsp
• MaxKeyContainerNameLength
• Nome
• Valid
• Versão

O método adiciona os algoritmos disponíveis à coleção ICspAlgorithms retornada pela propriedade CspAlgorithms . Chame o método InitializeFromName para inicializar o objeto de um nome CSP.

Requirements

Consulte também

ICspInformation