Compartilhar via


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

O método Initialize inicializa o objeto de um valor booliano e uma data.

Sintaxe

HRESULT Initialize(
  [in] VARIANT_BOOL BackedUpValue,
  [in] DATE         Date
);

Parâmetros

[in] BackedUpValue

Uma variável VARIANT_BOOL que identifica se o certificado foi feito backup.

[in] Date

Uma variável DATE que identifica quando um certificado foi feito backup pela última vez.

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.

Código/valor de retorno Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
O objeto já está inicializado.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
A hora especificada não é válida.

Observações

A data é armazenada como um valor real de 8 bytes, representando uma data entre 1º de janeiro de 1900 e 31 de dezembro de 9999, inclusive. O valor 2.0 representa 1º de janeiro de 1900; 3.0 representa 2 de janeiro de 1900. Adicionar 1 ao valor incrementa a data por um dia. A parte fracionária do valor representa a hora do dia. Portanto, 2.5 representa 12:00 em 1º de janeiro de 1900; 3.25 representa 06:00 em 2 de janeiro de 1900.

Para datas entre 1950 e 2049, inclusive, a data e a hora são codificadas utc-time no formulário YYMMDDHHMMSS. Para datas antes de 1950 ou após 2049, o tempo generalizado codificado é usado. O tempo generalizado codificado está no formato YYYYMMDDDHHMMSSMMM, usando um ano de quatro dígitos, e é preciso para milissegundos.

Chame o método SetValueOnCertificate para associar a propriedade a um certificado. Para recuperar a data, chame a propriedade BackedUpTime . Para recuperar o valor booliano que identifica se um certificado foi feito backup, chame a propriedade BackedUpValue .

Requirements

Requirement Value
Cliente mínimo suportado Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header certenroll.h
de DLL CertEnroll.dll

Consulte também

ICertProperty

ICertPropertyBackedUp