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

Confira também

SWbemDateTime.GetVarDate

SWbemDateTime

DATETIME