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 |
|
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |