RpcSmGetThreadHandle-Funktion (rpcndr.h)

  • Artikel

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

Syntax

RPC_SS_THREAD_HANDLE RpcSmGetThreadHandle(
  RPC_STATUS *pStatus
);

Parameter

pStatus

Zeiger auf die zurückgegebene status.

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

Anwendungen rufen RpcSmGetThreadHandle auf, um ein Threadhandle für die Stub-Speicherverwaltungsumgebung abzurufen. Ein Thread, der zum Verwalten des Arbeitsspeichers für die Stub-Speicherverwaltungsumgebung verwendet wird, verwendet RpcSmGetThreadHandle , um ein Handle für seine Speicherumgebung zu empfangen. Auf diese Weise kann ein anderer Thread, der RpcSmSetThreadHandle mithilfe dieses Handles aufruft, dann dieselbe Speicherverwaltungsumgebung verwenden.

Dasselbe Speicherverwaltungsthreadhandle muss von mehreren Threads verwendet werden, die RpcSmAllocate und RpcSmFree aufrufen, um denselben Arbeitsspeicher zu verwalten. Bevor neue Threads zur Verwaltung desselben Arbeitsspeichers erstellt werden, ruft der Thread, der die Speicherverwaltungsumgebung (übergeordneter Thread) eingerichtet hat , RpcSmGetThreadHandle auf, um ein Threadhandle für diese Umgebung zu erhalten. Anschließend rufen die erzeugten Threads RpcSmSetThreadHandle mit dem neuen Managerhandle auf, das vom übergeordneten Thread bereitgestellt wird.

In der Regel ruft eine Server-Manager-Prozedur RpcSmGetThreadHandle auf, bevor zusätzliche Threads erstellt 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

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 (rpc.h einschließen)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

RpcSmAllocate

RpcSmFree

RpcSmSetThreadHandle