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
RPC_S_OK	La chiamata ha avuto esito positivo.

 

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

 

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

Vedi anche

RpcSmAllocate

RpcSmFree

RpcSmSetThreadHandle