Share via

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

  • Artigo

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 de 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ço criptográfico) padrão será usado.

[in, optional] pAlgorithm

Ponteiro para uma interface IObjectId que representa um algoritmo OID. 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.

Retornar valor

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 possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Valor/código retornado Descrição
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 O objeto já está inicializado.

Comentários

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 :

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.

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

ICspInformation