RpcSmGetThreadHandle-Funktion (rpcndr.h)

Die RpcSmGetThreadHandle-Funktion gibt ein Threadhandle oder NULL für die Stub-Speicherverwaltungsumgebung zurück.

Syntax

RPC_SS_THREAD_HANDLE RpcSmGetThreadHandle(
  RPC_STATUS *pStatus
);

Die Parameter

pStatus

Zeiger auf den zurückgegebenen Status.

Rückgabewert

Bemerkungen

Anwendungen rufen RpcSmGetThreadHandle auf, um ein Threadhandle für die Speicherverwaltungsumgebung des Stubs abzurufen. Ein Thread zum Verwalten des Speichers für die Speicherverwaltungsumgebung für stub verwendet RpcSmGetThreadHandle , um ein Handle für seine Speicherumgebung zu empfangen. Auf diese Weise kann ein anderer Thread, der rpcSmSetThreadHandle mit diesem Handle aufruft, dann dieselbe Speicherverwaltungsumgebung verwenden.

Dasselbe Speicherverwaltungsthreadhandle muss von mehreren Threads verwendet werden, die RpcSmAllocate und RpcSmFree aufrufen, um denselben Speicher zu verwalten. Vor dem Spawning neuer Threads zum Verwalten desselben Speichers ruft der Thread, der die Speicherverwaltungsumgebung (übergeordneter Thread) eingerichtet hat , rpcSmGetThreadHandle auf, um ein Threadhandle für diese Umgebung abzurufen. Anschließend rufen die spawned Threads RpcSmSetThreadHandle mit dem neuen Managerhandle auf, der vom übergeordneten Thread bereitgestellt wird.

In der Regel ruft eine Server-Manager-Prozedur RpcSmGetThreadHandle auf, bevor zusätzliche Threads eingeblenährt werden. Der Stub richtet die Speicherverwaltungsumgebung für die Managerprozedur ein, und der Manager ruft RpcSmGetThreadHandle auf, um diese Umgebung für die anderen Threads verfügbar zu machen.

Ein Thread kann auch rpcSmGetThreadHandle und RpcSmSetThreadHandle aufrufen, um seine Speicherverwaltungsumgebung zu speichern und wiederherzustellen.

Anforderungen

Siehe auch

RpcSmAllocate

RpcSmFree

RpcSmSetThreadHandle