Metodo ICertPropertyBackedUp::Initialize (certenroll.h)

  • Articolo

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 L'oggetto è già inizializzato.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
 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

Vedi anche

ICertProperty

ICertPropertyBackedUp