Método SWbemDateTime.GetFileTime
O método GetFileTime do objeto SWbemDateTime converte um valor de data e hora no formato DATETIME do CIM para o formato FILETIME.
Se o parâmetro for definido como TRUE, o valor retornado representará uma hora local para o cliente. Caso contrário, o valor retornado será uma hora UTC (Tempo Universal Coordenado). Uma estrutura FILETIMEDATETIME é um valor de 64 bits que representa o número de unidades de 100 nanossegundos desde o início de 1º de janeiro de 1601. A WMI (Instrumentação de Gerenciamento do Windows) trata valores FILETIME como representações de cadeia de caracteres de números não de 64 bits sem sinal.
Para ver uma explicação dessa sintaxe, confira Convenções de documento para a API de script.
Sintaxe
vDate = .GetFileTime( _
[ ByVal bIsLocaL ] _
)
Parâmetros
-
bIsLocaL [entrada, opcional]
-
Indica se o valor retornado é interpretado como hora local. Assim, a propriedade UTC contém a hora local convertida para o deslocamento correto do UTC (Tempo Universal Coordenado). Se o valor for FALSE, ele será interpretado como UTC com um deslocamento zero (0).
Retornar valor
A data e a hora no formato FILETIME.
Códigos do Erro
Depois de concluir o método GetFileTime, o objeto Err poderá conter o código de erro na lista a seguir.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Falha na chamada.
Comentários
Os valores VT_DATE e FILETIME não podem conter campos curinga.
O método GetFileTime falhará (wbemErrFailed) se alguma das seguintes propriedades for FALSE:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
Em um retorno bem-sucedido de SetFileTime, todas essas propriedades são definidas como TRUE.
Exemplos
Para obter exemplos de como usar o objeto SWbemDateTime para converter valores DATETIME do CIM de e para o formato FILETIME ou o formato VT_DATE, confira Tarefas do WMI: Datas e Horas. Para obter uma descrição do formato DATETIME do CIM, confira Formato de data e hora.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Cabeçalho |
|
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |