Condividi tramite


Metodo RequestStateChange della classe CIM_LANEndpoint

Richiede che lo stato dell'elemento venga modificato nel valore specificato nel parametro RequestedState . Quando si verifica la modifica dello stato richiesto, EnabledState e RequestedState dell'elemento saranno uguali. La chiamata del metodo RequestChangeState più volte può comportare la sovrascrittura o la perdita delle richieste precedenti. Se viene restituito 0, l'attività è stata completata correttamente e l'uso di ConcreteJob non è stato necessario. Se viene restituito 4096 (0x1000), l'attività richiederà del tempo per completare, ConcreteJob verrà creato e il relativo riferimento restituito nel parametro di output Job. Qualsiasi altro codice restituito indica una condizione di errore.

Sintassi

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

Parametri

RequestedState [in]

Stato richiesto per l'elemento. Queste informazioni verranno inserite nella proprietà RequestedState dell'istanza se il codice restituito del metodo RequestStateChange è 0 ('Completed with No Error'), 3 ('Timeout') o 4096 (0x1000) ('Job Started'). Per le spiegazioni dettagliate dei valori RequestedState, vedere la descrizione delle proprietà EnabledState e RequestedState .

Abilitato (2)

Disabilitato (3)

Arresto (4)

Offline (6)

Test (7)

Rinvio (8)

Quiesce (9)

Riavvio (10)

Reimpostazione (11)

DMTF Riservato (12 32767)

Fornitore riservato (32768 65535)

Processo [out]

Un CIM_ConcreteJob che contiene un riferimento al processo (può essere Null se l'attività è stata completata).

TimeoutPeriod [in]

Periodo di timeout che specifica la quantità massima di tempo prevista dal client per la transizione al nuovo stato. Il formato intervallo deve essere utilizzato per specificare questo periodo. Un valore pari a 0 o un parametro Null indica che il client non ha requisiti di tempo per la transizione. Se questa proprietà non contiene 0 o null e l'implementazione non supporta questo parametro, deve essere restituito un codice restituito "Use Of Timeout Parameter Not Supported".

Valore restituito

Completata senza errore (0)

Non supportato (1)

Errore sconosciuto o non specificato (2)

Impossibile completare entro il periodo di timeout (3)

Non riuscito (4)

Parametro non valido (5)

In uso (6)

DMTF Riservato (7 4095)

Parametri del metodo controllati - Processo avviato (4096)

Transizione di stato non valida (4097)

Uso del parametro timeout non supportato (4098)

Occupato (4099)

Metodo riservato (4100 32767)

Specifica fornitore (32768 65535)

Requisiti

Client minimo supportato
Windows 8
Server minimo supportato
Windows Server 2012
Spazio dei nomi
Root\standardcimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll

Vedi anche

CIM_LANEndpoint