RpcSmSetThreadHandle-Funktion (rpcndr.h)

  • Artikel

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

Syntax

RPC_STATUS RpcSmSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Parameter

Id

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

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Eine Anwendung ruft RpcSmSetThreadHandle 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 RpcSmGetThreadHandle auf, um ein Handle für die Arbeitsspeicherumgebung abzurufen. Auf diese Weise kann ein anderer Thread, der RpcSmSetThreadHandle mit diesem Handle aufruft, dann dieselbe Speicherverwaltungsumgebung verwenden.

Dasselbe Speicherverwaltungs-Threadhandle muss von mehreren Threads verwendet werden, die RpcSmAllocate und RpcSmFree 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 , RpcSmGetThreadHandle auf, um ein Threadhandle für diese Umgebung abzurufen. Anschließend rufen die gespawnten Threads RpcSmSetThreadHandle mit dem neuen Managerhandle auf, das vom übergeordneten Thread bereitgestellt wird.

Beachten Sie, dass RpcSmSetThreadHandle normalerweise von einem Thread aufgerufen wird, der von einer Server-Manager-Prozedur ausgelöst 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 gespawnte Thread RpcSmGetThreadHandle auf, um Zugriff auf die Speicherverwaltungsumgebung des Managers zu erhalten.

Ein Thread kann auch RpcSmGetThreadHandle und RpcSmSetThreadHandle aufrufen, um die Speicherverwaltungsumgebung zu speichern und wiederherzustellen.

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

RpcSmAllocate

RpcSmFree

RpcSmGetThreadHandle