RpcSsSetThreadHandle 함수(rpcndr.h)

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

구문

void RpcSsSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

매개 변수

Id

RpcSsGetThreadHandle 호출에서 반환되는 스레드 핸들입니다.

반환 값

없음

설명

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

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

일반적으로 서버 관리자 프로시저에서 생성되는 스레드는 RpcSsSetThreadHandle을 호출합니다. 스텁은 관리자 프로시저에 대한 메모리 관리 환경을 설정하고, 관리자는 RpcSsGetThreadHandle 을 호출하여 스레드 핸들을 가져옵니다. 그런 다음, 생성된 각 스레드는 RpcSsGetThreadHandle 을 호출하여 관리자의 메모리 관리 환경에 액세스합니다.

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

참고RpcSsSetThreadHandle 루틴은 예외를 발생하지만 RpcSmSetThreadHandle 루틴은 오류 코드를 반환합니다.

 

요구 사항

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

추가 정보

RpcSmSetThreadHandle

RpcSsAllocate

RpcSsFree

RpcSsGetThreadHandle