Condividi tramite


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:

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
Wbemdisp.h
Libreria dei tipi
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemDateTime
IID
IID_ISWbemDateTime

Vedi anche

SWbemDateTime.GetVarDate

SWbemDateTime

DATETIME