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

El método InitializeFromCurrentTime inicializa la propiedad a partir de un valor booleano y la fecha y hora actuales del sistema.

Sintaxis

HRESULT InitializeFromCurrentTime(
  [in] VARIANT_BOOL BackedUpValue
);

Parámetros

[in] BackedUpValue

Variable VARIANT_BOOL que identifica si se ha realizado una copia de seguridad del 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

Internamente, InitializeFromCurrentTime llama a la función GetSystemTimeAsFileTime en el Windows SDK. 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 inclusive. El valor 2.0 representa el 1 de enero de 1900; 3.0 representa el 2 de enero de 1900. Al agregar 1 al valor, se 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 el 1 de enero de 1900; 3.25 representa las 06:00 el 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 el tiempo generalizado codificado. El tiempo generalizado codificado tiene el formato AAAAMMDDHHMMSSMMM, usando un año de cuatro dígitos y es preciso en 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