Funzione RpcSsSetThreadHandle (rpcndr.h)

Articolo
08/25/2023

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

Sintassi

void RpcSsSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Parametri

Id

Handle di thread restituito da una chiamata a RpcSsGetThreadHandle.

Valore restituito

nessuno

Osservazioni

Un'applicazione chiama RpcSsSetThreadHandle 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 RpcSsGetThreadHandle per ottenere 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 RpcSsAllocate e RpcSsFree 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. I thread generati chiamano quindi RpcSsSetThreadHandle con l'handle fornito dal thread padre.

In genere, un thread generato da una routine di gestione server chiama RpcSsSetThreadHandle. Lo stub configura l'ambiente di gestione della memoria per la procedura di gestione e il responsabile chiama RpcSsGetThreadHandle per ottenere un handle di thread. Ogni thread generato chiama quindi RpcSsGetThreadHandle per ottenere l'accesso all'ambiente di gestione della memoria del manager.

Un thread può anche chiamare RpcSsGetThreadHandle e RpcSsSetThreadHandle per salvare e ripristinare l'ambiente di gestione della memoria.

Nota La routine RpcSsSetThreadHandle genera eccezioni, mentre la routine RpcSmSetThreadHandle restituisce il codice di errore.

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

Condividi tramite