Funzione RpcSsGetThreadHandle (rpcndr.h)

Articolo
03/05/2024

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
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 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.

NotaRpcSsGetThreadHandle genera eccezioni, mentre RpcSmGetThreadHandle 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