Método SWbemDateTime.SetVarDate
O método SetVarDate do objeto SWbemDateTime converte uma data no formato VT_DATE para o formato de datetime do CIM.
Um valor VT_DATE é um valor de datetime variante que o Visual Basic e o ActiveX usam.
Para ver uma explicação dessa sintaxe, confira Convenções de documentação para a API de Script.
Sintaxe
SWbemDateTime.SetVarDate( _
ByVal vdate, _
[ ByVal bIsLocal ] _
)
Parâmetros
-
vdate [in]
-
O valor de data variante para definir o objeto. Esse parâmetro deve estar no formato VT_DATE.
-
bIsLocal [in, opcional]
-
Se TRUE, vdate será interpretado como uma hora local e a propriedade UTC (Tempo Universal Coordenado) conterá a hora local convertida para o deslocamento UTC correto. Quando bIsLocal é FALSE, vdate é 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 SetVarDate, o objeto Err poderá conter o código de erro na lista a seguir.
-
wbemErrInvalidSyntax – 2147749921 (0x80041021)
-
O formato de vdate não é válido.
Comentários
Após uma chamada bem-sucedida para SetVarDate, o valor DATETIME será interpretado como um valor de datetime absoluto, em vez de um intervalo, e a propriedade IsInterval será definida como FALSE.
A função intrínseca do Visual Basic ou do VBScript CDate fornece um valor de datetime no formato VT_DATE para entrada para o SetVarDate.
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 |