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 |
---|---|
|
L'oggetto è già inizializzato. |
|
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 |