RpcSsGetThreadHandle-Funktion (rpcndr.h)

Die Funktion RpcSsGetThreadHandle gibt ein Threadhandle für die Speicherverwaltungsumgebung des Stubs zurück.

Syntax

RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();

Rückgabewert

Bemerkungen

Eine Anwendung ruft RpcSsGetThreadHandle 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 RpcSsGetThreadHandle , um ein Handle für seine Speicherumgebung zu empfangen. Auf diese Weise kann ein anderer Thread, der rpcSsSetThreadHandle mithilfe dieses Handle aufruft, dann dieselbe Speicherverwaltungsumgebung verwenden.

Dasselbe Threadhandle muss von mehreren Threads verwendet werden, die RpcSsAllocate und RpcSsFree 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 , rpcSsGetThreadHandle auf, um ein Threadhandle für diese Umgebung abzurufen. Anschließend rufen die spawned Threads RpcSsSetThreadHandle mit dem vom übergeordneten Thread bereitgestellten Handle auf.

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

Ein Thread kann auch rpcSsGetThreadHandle und RpcSsSetThreadHandle aufrufen, um seine Speicherverwaltungsumgebung zu speichern und wiederherzustellen.

Anforderungen

Siehe auch

RpcSmGetThreadHandle

RpcSsAllocate

RpcSsFree

RpcSsSetThreadHandle