MSFT_NetTransportConnection 클래스의 RequestStateChange 메서드

요소의 상태를 RequestedState 매개 변수에 지정된 값으로 변경하도록 요청합니다. 요청된 상태 변경이 발생하면 요소의 EnabledState 및 RequestedState가 동일합니다. RequestChangeState 메서드를 여러 번 호출하면 이전 요청을 덮어쓰거나 손실할 수 있습니다. 0이 반환되면 작업이 성공적으로 완료되며 ConcreteJob을 사용할 필요가 없습니다. 4096(0x1000)이 반환되면 작업을 완료하는 데 다소 시간이 걸리고, ConcreteJob이 생성되며, 출력 매개 변수 작업에서 해당 참조가 반환됩니다. 다른 반환 코드는 오류 조건을 나타냅니다.

구문

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

매개 변수

RequestedState [in]

요소에 대해 요청된 상태입니다. RequestStateChange 메서드의 반환 코드가 0('오류 없이 완료됨'), 3('시간 제한') 또는 4096(0x1000)('작업이 시작됨')인 경우 이 정보는 인스턴스의 RequestedState 속성에 배치됩니다. RequestedState 값에 대한 자세한 설명은 EnabledState 및 RequestedState 속성에 대한 설명을 참조하세요.

사용(2)

사용 안 함(3)

종료(4)

오프라인(6)

테스트(7)

연기(8)

정지(9)

다시 부팅(10)

초기화(11)

DMTF 예약됨(12 32767)

공급업체 예약됨(32768 65535)

Job [out]

작업에 대한 참조가 포함된 CIM_ConcreteJob입니다(작업이 완료되면 null일 수 있음).

TimeoutPeriod [in]

클라이언트가 새로운 상태로 전환할 것으로 예상하는 최대 시간을 지정하는 시간 제한 기간입니다. 이 기간을 지정하려면 간격 형식을 사용해야 합니다. 0 값 또는 null 매개 변수는 클라이언트에 전환에 대한 시간 요구 사항이 없음을 나타냅니다. 이 속성에 0 또는 null이 포함되어 있지 않고 구현에서 이 매개 변수를 지원하지 않는 경우 '시간 제한 매개 변수 사용이 지원되지 않음' 반환 코드가 반환되어야 합니다.

반환 값

오류 없이 완료됨(0)

지원되지 않음(1)

알 수 없음 또는 지정되지 않은 오류(2)

제한 시간 내에 완료할 수 없음(3)

실패(4)

잘못된 매개 변수(5)

사용 중(6)

DMTF 예약됨(7 4095)

메서드 매개 변수가 선택됨 - 작업이 시작됨(4096)

잘못된 상태 전환(4097)

지원되지 않는 시간 제한 매개 변수 사용(4098)

사용 중(4099)

메서드 예약됨(4100 32767)

공급업체별(32768 65535)

요구 사항

지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
네임스페이스	Root\standardcimv2
MOF	NetTCPIP.mof
DLL	NetTCPIP.dll

참고 항목

MSFT_NetTransportConnection