MI_OperationOptions_SetTimeout 함수(mi.h)

특정 작업에 대한 작업 시간 제한을 설정합니다.

구문

MI_INLINE MI_Result MI_OperationOptions_SetTimeout(
  [in, out] MI_OperationOptions *options,
  [in]      const MI_Interval   *timeout
);

매개 변수

[in, out] options

MI_OperationOptions 구조체에 대한 포인터입니다.

[in] timeout

새 작업 시간 제한 값에 대한 포인터입니다.

반환 값

함수 반환 코드를 지정하는 MI_Result 열거형의 값입니다. 다음 코드 중 하나일 수 있습니다.

설명

이 시간 제한은 MI_DestinationOptions_SetTimeout 함수를 호출하여 대상 옵션에서 설정할 수 있습니다. 그러나 경우에 따라 한 작업이 다른 작업보다 오래 걸릴 수 있습니다. 따라서 모든 작업에 대해 적절한 기본값을 설정한 다음 이 함수를 사용하여 더 오래 걸릴 수 있는 특정 작업을 재정의하는 것이 가장 좋습니다.

클라이언트가 진행률을 요청하고 공급자가 진행률을 보고하는 경우 각 진행률 보고서 후에 시간 제한 간격이 다시 시작됩니다. 열거형/구독/연결의 경우 간격은 시간 초과되기 전에 개체가 전달되기 전의 최대 길이입니다(진행률 주석에 따라).

클라이언트가 Windows 원격 관리를 통해 CIM 세션에서 작업(예: 호출)을 수행하는 경우 대상 서버에 연결할 수 없는 경우(예: 서버 중단, 네트워크 중단 또는 예기치 않은 방화벽 예외로 인해) 작업 시간 제한 값보다 더 오래 걸릴 수 있습니다. 이 과도한 대기 시간은 작업이 서버에서 스키마 정보를 가져오기 위한 하위 작업으로 나눌 수 있고 클라이언트가 연결할 수 없는 서버에 의해 하나 이상의 스키마 페치 하위 작업이 차단된 경우에도 작업을 계속하기 때문에 발생합니다.

이 문제를 완화하고 클라이언트가 과도한 대기 시간 없이 결과를 보고하도록 하려면 다음 단계 중 하나 또는 둘 다를 시도합니다.

• Winrm set winrm/config/client @{NetworkDelayms="DesiredValue"} 명령을 호출하여 WinRM 네트워크 지연 시간을 매우 낮은 값으로 설정합니다. 여기서 DesiredValue는 네트워크 지연 값(밀리초)입니다. 지정할 수 있는 가장 낮은 네트워크 지연 시간은 500밀리초입니다.

  네트워크 지연 값은 대상 컴퓨터에 도달하는 동안 네트워크 대기 시간을 설명하는 데 도움이 됩니다. 그러나 작은 네트워크 지연 및 작업 시간 제한 값을 설정하는 경우 도달하는 데 시간이 오래 걸리는 대상 컴퓨터와 통신하지 못할 수 있습니다. 또한 네트워크 지연 값의 변경은 하나의 작업만이 아니라 전체 컴퓨터에 영향을 줍니다.

• 작업을 시작할 때("MI_Session_" 접두사를 사용하여 함수 호출) flags 매개 변수에 MI_OPERATIONFLAGS_STANDARD_RTTI 플래그를 지정합니다.

  이렇게 하면 페치 스키마 하위 작업이 실패할 경우 후속 페치 스키마 하위 작업이 완료될 때까지 기다리지 않고 작업이 중단되고 즉시 완료되도록 작업 동작이 변경됩니다. 따라서 작업이 시작될 때 서버에 항상 연결할 수 없는 경우 작업이 완료되는 데 걸리는 시간은 작업 시간 제한 값 및 WinRM 네트워크 지연 값의 합계와 같습니다.

요구 사항

추가 정보

MI_DestinationOptions_SetTimeout

MI_OperationOptions_GetTimeout

Windows 원격 관리