Funzione RpcSsGetThreadHandle (rpcndr.h)
La funzione RpcSsGetThreadHandle restituisce un handle di thread per l'ambiente di gestione della memoria stub.
Sintassi
RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();
Valore restituito
| Valore | Significato |
|---|---|
|
La chiamata ha avuto esito positivo. |
Commenti
Un'applicazione chiama RpcSsGetThreadHandle per ottenere un handle di thread per l'ambiente di gestione della memoria stub. Un thread usato per gestire la memoria per l'ambiente di gestione della memoria stub usa RpcSsGetThreadHandle per ricevere un handle per il relativo ambiente di memoria. In questo modo, un altro thread che chiama RpcSsSetThreadHandle usando questo handle può quindi usare lo stesso ambiente di gestione della memoria.
Lo stesso handle di thread deve essere usato da più thread che chiamano RPCSAllocate e RpcSFree per gestire la stessa memoria. Prima di generare nuovi thread per gestire la stessa memoria, il thread che ha stabilito l'ambiente di gestione della memoria (thread padre) chiama RpcSsGetThreadHandle per ottenere un handle di thread per questo ambiente. Quindi, i thread generati chiamano RpcSsSetThreadHandle con l'handle fornito dal thread padre.
In genere, una routine di gestione server chiama RpcSsGetThreadHandle prima che vengano generati thread aggiuntivi. Lo stub configura l'ambiente di gestione della memoria per la procedura di gestione e il gestore chiama RpcSsGetThreadHandle per rendere questo ambiente disponibile per gli altri thread.
Un thread può anche chiamare RpcSsGetThreadHandle e RpcSsSetThreadHandle per salvare e ripristinare l'ambiente di gestione della memoria.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | rpcndr.h (include Rpc.h) |
| Libreria | Rpcrt4.lib |
| DLL | Rpcrt4.dll |