RpcSsGetThreadHandle 함수(rpcndr.h)

RpcSsGetThreadHandle 함수는 스텁 메모리 관리 환경에 대한 스레드 핸들을 반환합니다.

구문

RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();

반환 값

값	의미
RPC_S_OK	호출이 성공했습니다.

 

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

 

설명

애플리케이션은 RpcSsGetThreadHandle 을 호출하여 스텁 메모리 관리 환경에 대한 스레드 핸들을 가져옵니다. 스텁 메모리 관리 환경의 메모리를 관리하는 데 사용되는 스레드는 RpcSsGetThreadHandle 을 사용하여 해당 메모리 환경에 대한 핸들을 받습니다. 이러한 방식으로 이 핸들을 사용하여 RpcSsSetThreadHandle 을 호출하는 다른 스레드는 동일한 메모리 관리 환경을 사용할 수 있습니다.

동일한 메모리를 관리하려면 RpcSsAllocate 및 RpcSsFree 를 호출하는 여러 스레드에서 동일한 스레드 핸들을 사용해야 합니다. 동일한 메모리를 관리하기 위해 새 스레드를 생성하기 전에 메모리 관리 환경(부모 스레드)을 설정한 스레드는 RpcSsGetThreadHandle 을 호출하여 이 환경에 대한 스레드 핸들을 가져옵니다. 그런 다음, 생성된 스레드는 부모 스레드에서 제공하는 핸들을 사용하여 RpcSsSetThreadHandle 을 호출합니다.

일반적으로 서버 관리자 프로시저는 추가 스레드가 생성되기 전에 RpcSsGetThreadHandle 을 호출합니다. 스텁은 관리자 프로시저에 대한 메모리 관리 환경을 설정하고, 관리자는 RpcSsGetThreadHandle 을 호출하여 이 환경을 다른 스레드에서 사용할 수 있도록 합니다.

스레드는 RpcSsGetThreadHandle 및 RpcSsSetThreadHandle 을 호출하여 메모리 관리 환경을 저장하고 복원할 수도 있습니다.

참고RpcSsGetThreadHandle 은 예외를 발생하지만 RpcSmGetThreadHandle 은 오류 코드를 반환합니다.

 

요구 사항

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

추가 정보

RpcSmGetThreadHandle

RpcSsAllocate

RpcSsFree

RpcSsSetThreadHandle