RpcServerTestCancel 함수(rpcdce.h)

아티클
08/25/2023

서버는 RpcServerTestCancel 을 호출하여 클라이언트 취소 요청을 테스트합니다.

구문

RPC_STATUS RpcServerTestCancel(
  RPC_BINDING_HANDLE BindingHandle
);

매개 변수

BindingHandle

를 호출하여 취소 명령을 테스트합니다. 값이 0으로 지정된 경우 서버는 이 서버 스레드에서 제공하는 클라이언트를 가장합니다.

반환 값

값	의미
RPC_S_OK	클라이언트에서 호출을 취소했습니다. 서버는 여전히 호출을 완료하거나 중단해야 합니다.
RPC_S_NO_CALL_ACTIVE	현재 스레드에 대한 활성 호출이 없습니다.
RPC_S_CALL_IN_PROGRESS	호출이 취소되지 않았습니다.
RPC_S_INVALID_BINDING	핸들이 잘못되었습니다.

참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.

설명

서버는 RpcServerTestCancel 을 호출하여 클라이언트가 미해결 호출 취소를 요청했는지 확인합니다. RpcServerTestCancel 함수는 클라이언트가 호출을 취소했는지 여부만 나타냅니다. 서버 또는 클라이언트에서 상태가 변경되지 않습니다. RpcAsyncCompleteCall 또는 RpcAsyncAbortCall 함수 호출을 각각 사용하여 RPC 서버에서 취소된 호출을 완료하거나 중단해야 합니다.

BindingHandle 매개 변수는 테스트할 호출을 지정합니다. 매개 변수 값이 0이면 현재 스레드에 대한 호출이 테스트됩니다. 서버는 RpcServerTestCancel(RpcAsyncGetCallHandle(pAsync)) 함수를 호출하여 비동기 핸들을 사용하여 바인딩 핸들을 가져오는 취소 메시지를 테스트할 수 있습니다.

요구 사항

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