Método WBEMTime::SetDMTF (wbemtime.h)

  • Artigo

[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

Confira também

WBEMTime

WBEMTime::GetBSTR

WBEMTime::GetDMTF