Método WBEMTime::SetDMTF (wbemtime.h)
[A classe WBEMTime faz parte da Estrutura do Provedor do WMI que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas em todos os novos desenvolvimentos.]
O método SetDMTF define a hora no objeto WBEMTime . A hora é fornecida pelo parâmetro BSTR em Formato de Data e Hora. Um argumento de data e hora antes da meia-noite de 1º de janeiro de 1601 não é válido.
Sintaxe
BOOL SetDMTF(
const BSTR wszText
);
Parâmetros
wszText
BSTR em Formato de Data e Hora.
Retornar valor
O método retornará true se a hora for válida e false se a hora não for válida.
Comentários
Internamente, o WBEMTime armazena um datetime como um inteiro de 64 bits. Por isso, a interpretação específica da implementação para o uso de um asterisco é necessária ao definir um datetime.
Quando um asterisco "*" aparece em qualquer local na cadeia de caracteres datetime de entrada, wszText é substituído posicionalmente pela cadeia de caracteres datetime padrão "16010101000000.000000+000".
O separador de microssegundos "." e o sinal de deslocamento UTC "+/-" devem estar presentes nos locais corretos. Todas as outras posições serão substituídas pelo elemento padrão se um asterisco for detectado no local correspondente.
Por exemplo, "1979**********.000000-0*4" torna-se "197910101000000.000000-004".
Como o WBEMTime armazena internamente todos os valores de datetime em GMT, o UTC resultante de -004 faz com que o campo de minuto seja alterado para que a representação interna se torne "197910105000000.000000+000".
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | wbemtime.h |
| DLL | FrameDynOS.dll; FrameDyn.dll |