Funzione RpcRevertToSelfEx (rpcdce.h)

La funzione RpcRevertToSelfEx consente a un server di rappresentare un client e quindi di ripristinare un'operazione multithreaded in cui la chiamata a rappresentare un client può venire da un thread diverso dal thread originariamente inviato da RPC.

Sintassi

RPC_STATUS RpcRevertToSelfEx(
  RPC_BINDING_HANDLE BindingHandle
);

Parametri

BindingHandle

Handle di associazione nel server che rappresenta un'associazione al client rappresentato dal server. Un valore pari a zero specifica l'handle client del thread corrente; in questo caso, la funzionalità di RpcRevertToSelfEx è identica a quella della funzione RpcRevertToSelf .

Valore restituito

Valore Significato
RPC_S_OK
La chiamata ha avuto esito positivo.
RPC_S_NO_CALL_ACTIVE
Il server non dispone di un client per rappresentare.
RPC_S_INVALID_BINDING
L'handle di associazione non è valido.
RPC_S_WRONG_KIND_OF_BINDING
Si tratta del tipo errato di associazione per questa operazione.
RPC_S_CANNOT_SUPPORT
La chiamata non è supportata per questo sistema operativo, questo trasporto o questo sottosistema di sicurezza.
 
Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.
 

Commenti

Dopo aver chiamato RpcImpersonateClient e completato tutte le attività che richiedono la rappresentazione client, il server chiama RpcRevertToSelfEx per terminare la rappresentazione e per ripristinare la propria identità di sicurezza. Si consideri ad esempio un thread primario, denominato thread1, che viene inviato da un client remoto e riattiva un thread di lavoro, denominato thread2. Se thread2 richiede che il server rappresenta il client, il server chiama RpcImpersonateClient(THREAD1_CALL_HANDLE), esegue l'attività richiesta, chiama RpcRevertToSelfEx(THREAD1_CALL_HANDLE) per terminare la rappresentazione e quindi riattiva thread1.

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 (include Rpc.h)
Libreria Rpcrt4.lib
DLL Rpcrt4.dll

Vedi anche

Rappresentazione client

RpcImpersonateClient

RpcRevertToSelf