Metodo SWbemDateTime.GetVarDate
Il metodo GetVarDate dell'oggetto SWbemDateTime converte un valore di data e ora nel formato CIM DATETIME nel formato VT_DATE .
Il formato VT_DATE è un valore DATETIME variante di automazione usato da Visual Basic e ActiveX.
Per una spiegazione di questa sintassi, vedere Document Conventions per l'API di scripting.
Sintassi
vdate = .GetVarDate( _
[ ByVal bIsLocal ] _
)
Parametri
-
bIsLocal [in, facoltativo]
-
Indica se il valore restituito viene interpretato come ora locale. La proprietà Coordinated Universal Time (UTC) contiene l'ora locale convertita nell'offset UTC corretto. Se il valore è FALSE, il valore viene interpretato come UTC con un offset zero (0).
Valore restituito
Valore di data e ora nel formato VT_DATE .
Commenti
VT_DATE e i valori FILETIME non possono contenere campi con caratteri jolly.
Il metodo GetVarDate ha esito negativo (wbemErrFailed) se una delle proprietà seguenti è FALSE:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
Al termine della restituzione da SetVarDate, tutte queste proprietà vengono impostate su TRUE.
Dopo la corretta chiamata a SetVarDate, il valore DATETIME viene sempre interpretato come un valore DATETIME assoluto anziché un intervallo e IsInterval è impostato su FALSE.
Se IsInterval è impostato su TRUE, una chiamata a GetVarDate restituisce l'errore wbemErrFailed .
Alcune perdite di precisione si verificano quando si chiama GetVarDate, perché i valori datetime hanno una risoluzione di un microsecondo ( s) e VT_DATE valori hanno una risoluzione di 500 millisecondi.
Esempio
Per esempi di utilizzo dell'oggetto SWbemDateTime per convertire i valori CIM DATETIME in e da fileTIME o dal formato di 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 |