Metodo ICertPropertyBackedUp::Initialize (certenroll.h)
Il metodo Initialize inizializza l'oggetto da un valore booleano e una data.
Sintassi
HRESULT Initialize(
[in] VARIANT_BOOL BackedUpValue,
[in] DATE Date
);
Parametri
[in] BackedUpValue
Variabile VARIANT_BOOL che identifica se il certificato è stato eseguito il backup.
[in] Date
Variabile DATE che identifica quando è stato eseguito l'ultimo backup di un 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 di codici di errore comuni, vedere Valori HRESULT comuni.
| Codice/valore restituito | Descrizione |
|---|---|
|
L'oggetto è già inizializzato. |
|
L'ora specificata non è valida. |
Commenti
La data viene archiviata come valore reale da 8 byte, che rappresenta una data compresa tra il 1° gennaio 1900 e il 31 dicembre 9999, inclusa. 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 per 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 le 06:00 il 2 gennaio 1900.
Per le date comprese tra il 1950 e il 2049, la data e l'ora vengono codificate utc nel formato YMMDDHHMMSS. Per le date precedenti al 1950 o dopo il 2049, viene usato l'ora generalizzata codificata. Il tempo generalizzato codificato è nel formato YYYYMMDHHMMSSMMM, usando un anno a quattro cifre ed è preciso per millisecondi.
Chiamare il metodo SetValueOnCertificate per associare la proprietà a un certificato. Per recuperare la data, chiamare la proprietà BackupUpTime . Per recuperare il valore booleano che identifica se è stato eseguito il backup di un certificato, chiamare la proprietà BackupUpValue .
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 |