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 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 |
---|---|
|
O objeto já está inicializado. |
|
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 |