다음을 통해 공유


RpcMgmtSetComTimeout 함수(rpcdce.h)

RpcMgmtSetComTimeout 함수는 바인딩 핸들에서 바인딩 통신 제한 시간 값을 설정합니다.

구문

RPC_STATUS RpcMgmtSetComTimeout(
  RPC_BINDING_HANDLE Binding,
  unsigned int       Timeout
);

매개 변수

Binding

시간 제한 값이 설정된 서버 바인딩 핸들입니다.

Timeout

통신 제한 시간 값(0에서 10까지)입니다. 이러한 값은 초가 아닙니다. 0에서 10까지의 척도에서 상대적인 시간을 나타냅니다.

반환 값

의미
RPC_S_OK
호출이 성공했습니다.
RPC_S_INVALID_BINDING
바인딩 핸들이 잘못되었습니다.
RPC_S_INVALID_TIMEOUT
시간 제한 값이 잘못되었습니다.
RPC_S_WRONG_KIND_OF_BINDING
작업에 대한 잘못된 종류의 바인딩이었습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

Windows XP 및 Windows 2000에서 바인딩하는 동안 RPC 런타임은 15분 통화 시간 제한의 짧은 시간 및 RpcMgmtSetComTimeout 함수를 사용하여 시간 제한 집합을 사용합니다. 바인딩 이후의 교환에서 RPC 런타임은 RpcMgmtSetComTimeout 함수를 사용하여 의 제한 시간 집합만 사용합니다. 이 옵션은 ncalrpcncadg_* 프로토콜 시퀀스에 대해 무시됩니다.

클라이언트 애플리케이션은 RpcMgmtSetComTimeout 을 호출하여 서버 바인딩 핸들에 대한 통신 제한 시간 값을 변경합니다. 지정된 바인딩 핸들에 대한 프로토콜 시퀀스에 따라 시간 제한 값은 RPC 런타임 라이브러리에 대한 힌트로만 작동합니다. 각 프로토콜 시퀀스는 이 설정을 다르게 해석합니다. ncacn_ip_tcp 경우 값은 모든 호출에 대해 keep-alive를 설정하는 데 사용됩니다. 예를 들어 ncacn_ip_tcp 시간 제한을 0으로 설정하면 응답이 60초 안에 수신되지 않는 경우 RPC가 연결 유지를 설정하도록 지시합니다(60초 간격은 구현에 따라 달라지고 변경될 수 있음). 이 경우 서버가 실행되는 한 클라이언트 호출 시간이 초과되지 않습니다. 그러나 서버가 실패하거나 IP 주소를 잃으면 RPC는 호출에 실패합니다. TCP 시간 제한 힌트는 연결 설정 중과 요청/회신 교환 중에 사용됩니다.

참고 TCP 시간 제한 힌트를 사용하는 것이 실패한 서버를 검색하는 모범 사례입니다.

Windows XP에서는 서버가 응답할 때 지정된 연결에 대한 연결 유지가 해제됩니다.

 
편의를 위해 제한 시간 범위의 특정 값에 대한 상수가 제공됩니다. 애플리케이션이 제한 시간 인수에 사용할 수 있는 RPC 정의 값 목록은 바인딩 시간 제한 상수를 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 rpcdce.h(Rpc.h 포함)
라이브러리 Rpcrt4.lib
DLL Rpcrt4.dll

추가 정보

RpcMgmtInqComTimeout