RpcMgmtSetComTimeout 함수(rpcdce.h)
RpcMgmtSetComTimeout 함수는 바인딩 핸들에서 바인딩 통신 제한 시간 값을 설정합니다.
구문
RPC_STATUS RpcMgmtSetComTimeout(
RPC_BINDING_HANDLE Binding,
unsigned int Timeout
);
매개 변수
Binding
시간 제한 값이 설정된 서버 바인딩 핸들입니다.
Timeout
통신 제한 시간 값(0에서 10까지)입니다. 이러한 값은 초가 아닙니다. 0에서 10까지의 척도에서 상대적인 시간을 나타냅니다.
반환 값
| 값 | 의미 |
|---|---|
|
호출이 성공했습니다. |
|
바인딩 핸들이 잘못되었습니다. |
|
시간 제한 값이 잘못되었습니다. |
|
작업에 대한 잘못된 종류의 바인딩이었습니다. |
설명
Windows XP 및 Windows 2000에서 바인딩하는 동안 RPC 런타임은 15분 통화 시간 제한의 짧은 시간 및 RpcMgmtSetComTimeout 함수를 사용하여 시간 제한 집합을 사용합니다. 바인딩 이후의 교환에서 RPC 런타임은 RpcMgmtSetComTimeout 함수를 사용하여 의 제한 시간 집합만 사용합니다. 이 옵션은 ncalrpc 및 ncadg_* 프로토콜 시퀀스에 대해 무시됩니다.
클라이언트 애플리케이션은 RpcMgmtSetComTimeout 을 호출하여 서버 바인딩 핸들에 대한 통신 제한 시간 값을 변경합니다. 지정된 바인딩 핸들에 대한 프로토콜 시퀀스에 따라 시간 제한 값은 RPC 런타임 라이브러리에 대한 힌트로만 작동합니다. 각 프로토콜 시퀀스는 이 설정을 다르게 해석합니다. ncacn_ip_tcp 경우 값은 모든 호출에 대해 keep-alive를 설정하는 데 사용됩니다. 예를 들어 ncacn_ip_tcp 시간 제한을 0으로 설정하면 응답이 60초 안에 수신되지 않는 경우 RPC가 연결 유지를 설정하도록 지시합니다(60초 간격은 구현에 따라 달라지고 변경될 수 있음). 이 경우 서버가 실행되는 한 클라이언트 호출 시간이 초과되지 않습니다. 그러나 서버가 실패하거나 IP 주소를 잃으면 RPC는 호출에 실패합니다. TCP 시간 제한 힌트는 연결 설정 중과 요청/회신 교환 중에 사용됩니다.
Windows XP에서는 서버가 응답할 때 지정된 연결에 대한 연결 유지가 해제됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | rpcdce.h(Rpc.h 포함) |
| 라이브러리 | Rpcrt4.lib |
| DLL | Rpcrt4.dll |