Compartilhar via


Método SWbemDateTime.SetFileTime

O método SetFileTime do objeto SWbemDateTime converte uma data no formato de cadeia de caracteres FILETIME no formato datetime do CIM.

O formato FILETIME é uma estrutura de datetime 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 obter a explicação da sintaxe, consulte Convenções de documento para a API de Script.

Sintaxe

SWbemDateTime.SetFileTime( _
  ByVal strFileTime, _
  [ ByVal bIsLocal ] _
)

Parâmetros

strFileTime [in]

Valor de FILETIME usado para definir o objeto .

bIsLocal [in, opcional]

Se TRUE, strFileTime será interpretado como uma hora local. A propriedade UTC (Tempo Universal Coordenado) contém a hora local convertida no deslocamento UTC correto. Quando bIsLocal é FALSE, strFileTime é convertido diretamente em um valor UTC com um deslocamento de 0 (zero).

Retornar valor

Esse método não retorna um valor.

Códigos do Erro

Depois de concluir o método SetFileTime, o objeto Err poderá conter o código de erro na lista a seguir.

wbemErrInvalidSyntax – 2147749921 (0x80041021)

O formato de strFileTime não é válido.

Comentários

Após uma chamada bem-sucedida para SetFileTime, o valor datetime sempre é interpretado como um valor (datetime) absoluto e IsInterval é definido como FALSE.

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
Wbemdisp.h
Biblioteca de tipos
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemDateTime
IID
IID_ISWbemDateTime

Confira também

SWbemDateTime.SetVarDate

SWbemDateTime

DATETIME