RpcSsGetThreadHandle-Funktion (rpcndr.h)
Die RpcSsGetThreadHandle-Funktion gibt ein Threadhandle für die Stub-Speicherverwaltungsumgebung zurück.
Syntax
RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
Hinweise
Eine Anwendung ruft RpcSsGetThreadHandle auf, um ein Threadhandle für die Stub-Speicherverwaltungsumgebung abzurufen. Ein Thread, der zum Verwalten des Arbeitsspeichers für die Stubspeicher-Verwaltungsumgebung verwendet wird, verwendet RpcSsGetThreadHandle , um ein Handle für seine Speicherumgebung zu empfangen. 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 eine Server-Manager-Prozedur RpcSsGetThreadHandle auf, bevor zusätzliche Threads erstellt 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 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 |