RpcSsSetThreadHandle-Funktion (rpcndr.h)

Artikel
03/01/2024

Die RpcSsSetThreadHandle-Funktion legt ein Threadhandle für die Stub-Speicherverwaltungsumgebung fest.

Syntax

void RpcSsSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Parameter

Id

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

Rückgabewert

Keine

Bemerkungen

Eine Anwendung ruft RpcSsSetThreadHandle auf, um ein Threadhandle für die Stub-Speicherverwaltungsumgebung festzulegen. Ein Thread, der zum Verwalten des Arbeitsspeichers für die Stubspeicher-Verwaltungsumgebung verwendet wird, ruft RpcSsGetThreadHandle auf, um ein Handle für die Speicherumgebung abzurufen. Auf diese Weise kann ein anderer Thread, der RpcSsSetThreadHandle mit diesem Handle aufruft, dieselbe Speicherverwaltungsumgebung verwenden.

Dasselbe Threadhandle muss von mehreren Threads verwendet werden , die RpcSsAllocate und RpcSsFree aufrufen, um denselben Arbeitsspeicher zu verwalten. Vor dem Spawnen neuer Threads zum Verwalten desselben Arbeitsspeichers ruft der Thread, der die Speicherverwaltungsumgebung (übergeordneter Thread) eingerichtet hat , RpcSsGetThreadHandle auf, um ein Threadhandle für diese Umgebung abzurufen. Anschließend rufen die gespawnten Threads RpcSsSetThreadHandle mit dem vom übergeordneten Thread bereitgestellten Handle auf.

In der Regel ruft ein Thread, der von einer Server-Manager-Prozedur ausgelöst wird , RpcSsSetThreadHandle auf. Der Stub richtet die Speicherverwaltungsumgebung für die Managerprozedur ein, und der Manager ruft RpcSsGetThreadHandle auf, um ein Threadhandle abzurufen. Anschließend ruft jeder gespawnte Thread RpcSsGetThreadHandle auf, um Zugriff auf die Speicherverwaltungsumgebung des Managers zu erhalten.

Ein Thread kann auch RpcSsGetThreadHandle und RpcSsSetThreadHandle aufrufen, um die Speicherverwaltungsumgebung zu speichern und wiederherzustellen.

Hinweis Die RpcSsSetThreadHandle-Routine löst Ausnahmen aus, während die RpcSmSetThreadHandle-Routine den Fehlercode zurückgibt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	rpcndr.h (include Rpc.h)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen