Funzione RpcSmSetThreadHandle (rpcndr.h)

La funzione RpcSmSetThreadHandle imposta un handle di thread per l'ambiente di gestione della memoria stub.

Sintassi

RPC_STATUS RpcSmSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Parametri

Id

Handle di thread restituito da una chiamata a RpcSmGetThreadHandle.

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

Un'applicazione chiama RpcSmSetThreadHandle per impostare 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 chiama RpcSmGetThreadHandle per ottenere un handle per il relativo 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 di gestione della memoria-thread 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. I thread generati chiamano quindi RpcSmSetThreadHandle con il nuovo handle di gestione fornito dal thread padre.

Si noti che RpcSmSetThreadHandle viene in genere chiamato da un thread generato da una routine server-manager. Lo stub configura l'ambiente di gestione della memoria per la procedura di gestione e il responsabile chiama RpcSmGetThreadHandle per ottenere un handle di thread. Ogni thread generato chiama quindi RpcSmGetThreadHandle per ottenere l'accesso all'ambiente di gestione della memoria del manager.

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

RpcSmGetThreadHandle