RpcSmGetThreadHandle 함수(rpcndr.h)

  • 아티클

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

구문

RPC_SS_THREAD_HANDLE RpcSmGetThreadHandle(
  RPC_STATUS *pStatus
);

매개 변수

pStatus

반환된 상태 대한 포인터입니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

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

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

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

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

요구 사항

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

추가 정보

RpcSmAllocate

RpcSmFree

RpcSmSetThreadHandle