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

  • Artículo

El método Initialize inicializa el objeto a partir de un valor booleano y una fecha.

Sintaxis

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

Parámetros

[in] BackedUpValue

Variable VARIANT_BOOL que identifica si se ha realizado una copia de seguridad del certificado.

[in] Date

Variable DATE que identifica cuándo se realizó una copia de seguridad por última vez de un certificado.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código o valor devuelto Descripción
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 El objeto ya se ha inicializado.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
 La hora especificada no es válida.

Comentarios

La fecha se almacena como un valor real de 8 bytes, que representa una fecha entre el 1 de enero de 1900 y el 31 de diciembre de 9999, ambos incluidos. El valor 2.0 representa el 1 de enero de 1900; 3.0 representa el 2 de enero de 1900. Agregar 1 al valor incrementa la fecha en un día. La parte fraccionarcional del valor representa la hora del día. Por lo tanto, 2.5 representa las 12:00 del 1 de enero de 1900; 3.25 representa las 06:00 del 2 de enero de 1900.

Para las fechas entre 1950 y 2049 inclusive, la fecha y la hora se codifican en hora UTC con el formato AAAMMDDHHMMSS. Para las fechas anteriores a 1950 o posteriores a 2049, se usa la hora generalizada codificada. El tiempo generalizado codificado tiene el formato AAAAMMDDHHMMSSMMM, usando un año de cuatro dígitos y es preciso para milisegundos.

Llame al método SetValueOnCertificate para asociar la propiedad a un certificado. Para recuperar la fecha, llame a la propiedad BackedUpTime . Para recuperar el valor booleano que identifica si se ha realizado una copia de seguridad de un certificado, llame a la propiedad BackedUpValue .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

ICertProperty

ICertPropertyBackedUp