RpcSsDestroyClientContext 함수(rpcndr.h)

RpcSsDestroyClientContext 함수는 서버에 연결하지 않고 클라이언트에서 더 이상 필요하지 않은 컨텍스트 핸들을 삭제합니다.

구문

void RpcSsDestroyClientContext(
  void **ContextHandle
);

매개 변수

ContextHandle

삭제할 컨텍스트 핸들입니다. RpcSsDestroyClientContext가 반환되기 전에 핸들이 NULL로 설정됩니다.

반환 값

RpcSsDestroyClientContext 에는 반환 값이 없습니다.

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

 

설명

RpcSsDestroyClientContext 는 클라이언트 애플리케이션에서 클라이언트의 컨텍스트 핸들을 유지하는 데 사용되는 메모리 리소스를 회수하는 데 사용됩니다. 이 함수는 통신 오류가 발생하고 서버를 더 이상 사용할 수 없는 경우와 같이 ContextHandle 이 더 이상 유효하지 않을 때 사용됩니다. 컨텍스트 핸들이 NULL로 설정됩니다. RpcSsDestroyClientContext 함수는 RpcSmDestroyClientContext 함수와 동일한 기능을 제공합니다. 이 함수는 서버의 컨텍스트 핸들 런다운 프로세스를 호출하지 않습니다.

RpcSsDestroyClientContext를 사용하여 컨텍스트 핸들을 닫는 서버 함수를 바꾸지 마세요.

RpcSsDestroyClientContext 함수는 전달된 컨텍스트 핸들이 잘못된 경우 RPC_X_SS_CONTEXT_MISMATCH 예외를 throw할 수 있습니다. 애플리케이션은 잘못된 컨텍스트 핸들을 이 함수에 전달해서는 안 됩니다. 예외가 throw되면 호출 코드의 오류를 나타내므로 조사 및 수정해야 합니다.

요구 사항

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

추가 정보

RpcBindingReset

RpcSmDestroyClientContext