Méthode RequestStateChange de la classe MSFT_NetTCPConnection

Article
03/11/2025

Demande que l’état de l’élément soit modifié par la valeur spécifiée dans le paramètre RequestedState. Lorsque la modification d’état demandée a lieu, EnabledState et RequestedState de l’élément sont identiques. L’appel de la méthode RequestChangeState plusieurs fois peut entraîner le remplacement ou la perte des requêtes antérieures. Si 0 est retourné, la tâche s’est terminée correctement et l’utilisation de ConcreteJob n’a pas été requise. Si la valeur 4096 (0x1000) est retournée, la tâche prendra un certain temps, ConcreteJob sera créée et sa référence retournée dans le travail du paramètre de sortie. 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]

État demandé pour l’élément. Ces informations sont placées dans la propriété RequestState de l’instance si le code de retour de la méthode RequestStateChange est 0 ('Terminé sans erreur'), 3 ('Timeout') ou 4096 (0x1000) ('Travail démarré'). Reportez-vous à la description des propriétés EnabledState et RequestedState pour obtenir des explications détaillées sur les valeurs RequestedState.

activé (2)
désactivé (3)
arrêter (4)
hors connexion (6)
test (7)
différer (8)
Quiesce (9)
redémarrage (10)
réinitialiser (11)
réservée DMTF (12 32767)
Fournisseur réservé (32768 65535)

de travaux [out]

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

TimeoutPeriod [in]

Délai d’attente qui spécifie la durée maximale pendant laquelle le client attend la transition vers le nouvel état. Le format d’intervalle doit être utilisé pour spécifier cette période. La valeur 0 ou un paramètre Null indique que le client n’a aucune exigence de temps 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 « Use Of Timeout Parameter Not Supported » doit être retourné.

Valeur de retour

terminé sans erreur (0)
non pris en charge (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)
réservée DMTF (7 4095)
paramètres de méthode Checked - Travail démarré (4096)
transition d’état non valide (4097)
utilisation du paramètre timeout non pris en charge (4098)
occupé (4099)
méthode réservée (4100 32767)
fournisseur spécifique (32768 65535)

Exigences


Client minimum pris en charge	Windows 8
Serveur minimum pris en charge	Windows Server 2012
Namespace	Root\standardcimv2
MOF	NetTCPIP.mof
DLL	NetTCPIP.dll

Voir aussi

MSFT_NetTCPConnection

Partager via