Funzione RpcSsDontSerializeContext (rpcdce.h)

Articolo
03/08/2023

La funzione RpcSsDontSerializeContext disabilita la serializzazione in fase di esecuzione di più chiamate inviate alle routine di server-manager nello stesso handle di contesto. L'uso di questa funzione non è consigliato. Gli sviluppatori devono usare invece la serializzazione dell'handle di contenuto in modalità mista. La sezione Vedere anche fornisce collegamenti a funzioni più appropriate.

Sintassi

void RpcSsDontSerializeContext();

Valore restituito

nessuno

Osservazioni

La funzione RpcSsDontSerializeContext impedisce al runtime di eseguire questo servizio di serializzazione, consentendo l'invio di più chiamate in un handle di contesto specifico. La chiamata a questa funzione non disabilita completamente la serializzazione. Quando si verifica un'esecuzione del contesto, la routine di esecuzione del contesto non verrà eseguita fino al completamento di tutte le richieste client in sospeso. Le modifiche allo stato dell'handle di contesto, inclusa la liberazione dell'handle di contesto in genere, devono continuare a essere serializzate.

È consigliabile che, se l'applicazione distribuita richiama la funzione RpcSsDontSerializeContext , la chiamata deve essere eseguita prima che il programma server inizi a gestire le chiamate di routine remota.

Nota In genere, il runtime RPC serializza le chiamate sullo stesso handle di contesto inviato alle routine di Server Manager. Gli handle di contesto vengono mantenuti in base al client e in genere rappresentano lo stato lato server. Ciò significa che il gestore server non deve proteggersi da un altro thread dallo stesso client che modifica il contesto o rispetto al contesto in esecuzione durante l'invio di una chiamata.

Nota Dopo la chiamata, la funzione RpcSsDontSerializeContext non è ripristinabile per la durata del processo.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rpcdce.h
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll