Méthode RequestStateChange de la classe CIM_ProtocolEndpoint

Demande que l’état de l’élément soit modifié en fonction de la valeur spécifiée dans le paramètre RequestedState. Lorsque la modification d’état demandé a lieu, les états EnabledState et RequestedState de l’élément sont identiques. Le fait d’invoquer plusieurs fois la méthode RequestChangeState pourrait entraîner l’écrasement ou la perte des demandes antérieures. Si la valeur 0 est rendue, la tâche s’achève avec succès et l’utilisation de ConcreteJob n’est pas nécessaire. Si 4096 (0x1000) est rendue, la tâche prendra un certain temps, ConcreteJob sera créé et sa référence sera rendue dans le paramètre de sortie Projet. Tout autre code de retour indique une condition d’erreur.

Syntaxe

uint32 RequestStateChange(
  [in]  uint16          RequestedState,
  [out] CIM_ConcreteJob Job,
  [in]  datetime        TimeoutPeriod
);

Paramètres

RequestedState [in]

L’état demandé pour l’élément. Cette information sera placée dans la propriété RequestedState de l’instance si le code de retour de la méthode RequestStateChange est 0 (« Terminé en affichant le message Pas d’erreur »), 3 (« Délai d’expiration ») ou 4096 (0x1000) (« Début de projet »). Reportez-vous à la description des propriétés EnabledState et RequestedState pour obtenir des explications détaillées sur les valeurs de RequestedState.

Activé (2)

Désactivé (3)

Arrêter (4)

Hors connexion (6)

Test (7)

Échelonner (8)

Suspendre (9)

Redémarrer (10)

Réinitialiser (11)

DMTF réservé (12 32767)

Réservé au fournisseur (32768 65535)

Projet [out]

Un CIM_ConcreteJob qui contient une référence au projet (peut être nul si la tâche est terminée).

TimeoutPeriod [in]

Une période de délai d’expiration qui spécifie le temps maximum que le client attend pour la transition vers le nouvel état. Le format d’intervalle doit être utilisé pour spécifier cette période. Une valeur de 0 ou un paramètre nul indique que le client n’a pas d’exigences temporelles pour la transition. Si cette propriété ne contient pas 0 ou null et que l’implémentation ne prend pas en charge ce paramètre, un code de retour « L’utilisation du paramètre Délai d’expiration n’est pas prise en charge » doit être renvoyé.

Valeur retournée

Effectué sans erreur (0)

Non supporté (1)

Erreur inconnue ou non spécifiée (2)

Impossible de terminer dans le délai d’expiration (3)

Échec (4)

Paramètre non valide (5)

En cours d’utilisation (6)

DMTF réservé (7 4095)

Paramètres de méthode vérifiés - Début du projet (4096)

Transition d’état non valable (4097)

L’utilisation du paramètre Délai d’expiration n’est pas prise en charge (4098)

Occupé (4099)

Méthode réservée (4100 32767)

Spécifique du fournisseur (32768 65535)

Spécifications

Voir aussi

CIM_ProtocolEndpoint