Metodo SWbemDateTime.GetFileTime
Il metodo GetFileTime dell'oggetto SWbemDateTime converte un valore di data e ora nel formato CIM DATETIME nel formato FILETIME.
Se il parametro è impostato su TRUE, il valore restituito rappresenta un'ora locale per il client. In caso contrario, il valore restituito è un'ora UTC (Coordinated Universal Time). Una struttura FILETIMEDATETIME è un valore a 64 bit che rappresenta il numero di unità da 100 nanosecondi dall'inizio del 1° gennaio 1601. Strumentazione gestione Windows (WMI) considera i valori FILETIME come rappresentazioni di stringa di numeri senza segno a 64 bit.
Per una spiegazione di questa sintassi, vedere Document Conventions per l'API di scripting.
Sintassi
vDate = .GetFileTime( _
[ ByVal bIsLocaL ] _
)
Parametri
-
bIsLocaL [in, facoltativo]
-
Indica se il valore restituito viene interpretato come ora locale. La proprietà UTC contiene quindi l'ora locale convertita nell'offset UTC (Coordinated Universal Times) corretto. Se il valore è FALSE, il valore viene interpretato come UTC con un offset zero (0).
Valore restituito
Data e ora nel formato FILETIME .
Codici di errore
Dopo aver completato il metodo GetFileTime , l'oggetto Err può contenere il codice di errore nell'elenco seguente.
-
wbemErrFailed - 2147749889 (0x80041001)
-
La chiamata non è riuscita.
Commenti
VT_DATE e i valori FILETIME non possono contenere campi con caratteri jolly.
Il metodo GetFileTime ha esito negativo (wbemErrFailed) se una delle proprietà seguenti è FALSE:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
In caso di restituzione riuscita da SetFileTime, tutte queste proprietà sono impostate su TRUE.
Esempio
Per esempi di utilizzo dell'oggetto SWbemDateTime per convertire i valori CIM DATETIME in e dal formato FILETIME o dal formato VT_DATE , vedere Attività WMI: Date e ore. Per una descrizione del formato CIM DATETIME , vedere Formato di data e ora.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Intestazione |
|
| Libreria dei tipi |
|
| DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |