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 |