RpcSmSetThreadHandle-Funktion (rpcndr.h)

Die Funktion RpcSmSetThreadHandle legt ein Threadhandle für die Speicherverwaltungsumgebung für stub fest.

Syntax

RPC_STATUS RpcSmSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Die Parameter

Id

Threadhandle, das von einem Aufruf von RpcSmGetThreadHandle zurückgegeben wird.

Rückgabewert

Bemerkungen

Eine Anwendung ruft RpcSmSetThreadHandle auf, um ein Threadhandle für die Stub-Speicherverwaltungsumgebung festzulegen. Ein Thread, der zum Verwalten des Speichers für die Speicherverwaltungsumgebung für stub verwendet wird, ruft RpcSmGetThreadHandle auf, um ein Handle für seine Speicherumgebung abzurufen. 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.

Beachten Sie, dass RpcSmSetThreadHandle in der Regel von einem Thread aufgerufen wird, der von einer Server-Manager-Prozedur durchsucht wird. Der Stub richtet die Speicherverwaltungsumgebung für die Managerprozedur ein, und der Manager ruft RpcSmGetThreadHandle auf, um ein Threadhandle abzurufen. Anschließend ruft jeder spawned Thread RpcSmGetThreadHandle auf, um Zugriff auf die Speicherverwaltungsumgebung des Managers zu erhalten.

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

Anforderungen

Siehe auch

RpcSmAllocate

RpcSmFree

RpcSmGetThreadHandle