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

  • Artigo

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 copiado em backup.

[in] Date

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

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.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
 A hora especificada não é válida.

Comentários

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 em 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 hora são codificadas utc-time no formato YYMMDDHHMMSS. Para datas antes de 1950 ou após 2049, o tempo generalizado codificado é usado. O tempo generalizado codificado está no formato YYYYMMDDHHMMSSMMM, 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 copiado em backup, chame a propriedade BackedUpValue .

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

ICertProperty

ICertPropertyBackedUp