Funzione RpcSmGetThreadHandle (rpcndr.h)
La funzione RpcSmGetThreadHandle restituisce un handle di thread o NULL per l'ambiente di gestione della memoria stub.
Sintassi
RPC_SS_THREAD_HANDLE RpcSmGetThreadHandle(
RPC_STATUS *pStatus
);
Parametri
pStatus
Puntatore allo stato restituito.
Valore restituito
| Valore | Significato |
|---|---|
|
La chiamata ha avuto esito positivo. |
Commenti
Le applicazioni chiamano RpcSmGetThreadHandle 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 RpcSmGetThreadHandle per ricevere un handle per l'ambiente di memoria. In questo modo, un altro thread che chiama RpcSmSetThreadHandle usando questo handle può quindi usare lo stesso ambiente di gestione della memoria.
Lo stesso handle del thread di gestione della memoria deve essere usato da più thread che chiamano RpcSmAllocate e RpcSmFree 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 RpcSmGetThreadHandle per ottenere un handle di thread per questo ambiente. Quindi, i thread generati chiamano RpcSmSetThreadHandle con il nuovo handle di gestione fornito dal thread padre.
In genere, una routine di gestione server chiama RpcSmGetThreadHandle prima che vengano generati thread aggiuntivi. Lo stub configura l'ambiente di gestione della memoria per la procedura di gestione e il gestore chiama RpcSmGetThreadHandle per rendere questo ambiente disponibile per gli altri thread.
Un thread può anche chiamare RpcSmGetThreadHandle e RpcSmSetThreadHandle 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 |