Condividi tramite


Metodo ICertPropertyBackedUp::InitializeFromCurrentTime (certenroll.h)

Il metodo InitializeFromCurrentTime inizializza la proprietà da un valore booleano e dalla data e dall'ora di sistema correnti.

Sintassi

HRESULT InitializeFromCurrentTime(
  [in] VARIANT_BOOL BackedUpValue
);

Parametri

[in] BackedUpValue

Variabile VARIANT_BOOL che identifica se è stato eseguito il backup del certificato.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito Descrizione
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
L'oggetto è già inizializzato.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
L'ora specificata non è valida.

Commenti

Internamente, InitializeFromCurrentTime chiama la funzione GetSystemTimeAsFileTime nel Windows SDK. La data viene archiviata come valore reale a 8 byte, che rappresenta una data compresa tra il 1° gennaio 1900 e il 31 dicembre 9999, inclusi. Il valore 2.0 rappresenta il 1° gennaio 1900; 3.0 rappresenta il 2 gennaio 1900. L'aggiunta di 1 al valore incrementa la data di un giorno. La parte frazionaria del valore rappresenta l'ora del giorno. Pertanto, 2,5 rappresenta 12:00 il 1° gennaio 1900; 3.25 rappresenta 06:00 il 2 gennaio 1900.

Per le date comprese tra il 1950 e il 2049, la data e l'ora sono codificate in formato UTC nel formato YYMMDDHHMMSS. Per le date precedenti al 1950 o dopo il 2049, viene utilizzato l'ora generalizzata codificata. Il tempo generalizzato codificato è nel formato AAAAMMGGHHMMSSMMM, usando un anno a quattro cifre ed è preciso in millisecondi.

Chiamare il metodo SetValueOnCertificate per associare la proprietà a un certificato. Per recuperare la data, chiamare la proprietà BackedUpTime . Per recuperare il valore booleano che identifica se è stato eseguito il backup di un certificato, chiamare la proprietà BackedUpValue .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certenroll.h
DLL CertEnroll.dll

Vedi anche

ICertProperty

ICertPropertyBackedUp