Partager via

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

  • Article

[La classe WBEMTime fait partie du framework du fournisseur WMI qui est maintenant considéré comme étant à l’état final, et plus aucun développement, amélioration ou mise à jour ne seront mis à disposition pour les problèmes non liés à la sécurité affectant ces bibliothèques. Les API MI doivent être utilisées pour tout nouveau développement.]

La méthode SetDMTF définit l’heure dans l’objet WBEMTime . L’heure est donnée par son paramètre BSTR au format Date et Heure. Un argument de date et d’heure antérieur à minuit le 1er janvier 1601 n’est pas valide.

Syntaxe

BOOL SetDMTF(
  const BSTR wszText
);

Paramètres

wszText

BSTR au format de date et d’heure.

Valeur retournée

La méthode retourne true si l’heure est valide et false si l’heure n’est pas valide.

Remarques

En interne, WBEMTime stocke un datetime sous forme d’entier 64 bits. Pour cette raison, une interprétation spécifique à l’implémentation de l’utilisation d’un astérisque est requise lors de la définition d’une dateheure.

Lorsqu’un astérisque « * » s’affiche à n’importe quel emplacement dans la chaîne datetime entrante, wszText est remplacé sur une base positionnelle par la chaîne datetime par défaut « 16010101000000.000000+0000 ».

Le séparateur de microsecondes « » et le signe de décalage UTC « +/- » doivent être présents aux emplacements appropriés. Toutes les autres positions sont remplacées par l’élément par défaut si un astérisque est détecté à l’emplacement correspondant.

Par exemple, « 1979**********.000000-0*4 » devient « 197910101000000.000000-004 ».

Étant donné que WBEMTime stocke en interne toutes les valeurs datetime dans GMT, l’UTC résultant de -004 entraîne la modification du champ minute de sorte que la représentation interne devient « 1979101050000000.0000000+000 ».

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête wbemtime.h
DLL FrameDynOS.dll ; FrameDyn.dll

Voir aussi

WBEMTime

WBEMTime ::GetBSTR

WBEMTime ::GetDMTF