Método ICspStatus::Initialize (certenroll.h)

O método Initialize inicializa o objeto de um provedor criptográfico e de um algoritmo associado. Esse método está habilitado para a Web.

Sintaxe

HRESULT Initialize(
  [in]           ICspInformation *pCsp,
  [in, optional] ICspAlgorithm   *pAlgorithm
);

Parâmetros

[in] pCsp

Ponteiro para uma interface ICspInformation que representa informações sobre o provedor.

[in, optional] pAlgorithm

Ponteiro para uma interface ICspAlgorithm que representa um algoritmo compatível com o provedor identificado no parâmetro pCsp . Esse parâmetro é opcional e pode ser NULL.

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 Initialize salva os objetos ICspInformation e ICspAlgorithm especificados nas propriedades CspInformation e CspAlgorithm . O método também cria um objeto IX509EnrollmentStatus vazio e o salva na propriedade EnrollmentStatus .

Uma coleção ICspStatuses normalmente é inicializada por um objeto IX509CertificateRequestPkcs10 . O método Initialize foi fornecido para que você possa criar objetos ICspStatus para adicionar a uma coleção personalizada.

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

ICspStatus

ICspStatuses