Funzione RpcServerInqBindingHandle (rpcdce.h)
La funzione RpcServerInqBindingHandle ottiene l'handle di associazione per le chiamate RPC gestite dal thread in cui viene chiamato RpcServerInqBindingHandle .
Sintassi
RPC_STATUS RpcServerInqBindingHandle(
RPC_BINDING_HANDLE *Binding
);
Parametri
Binding
RPC_BINDING_HANDLE struttura che, in caso di esito positivo, riceve l'handle di associazione per la chiamata gestita dal thread in cui viene chiamato anche RpcServerInqBindingHandle .
Se la chiamata non riesce, questo parametro non è definito.
Valore restituito
Questa funzione restituisce RPC_S_OK in caso di esito positivo; in caso contrario, viene restituito un codice di errore RPC_S_*. Questa funzione non può avere esito negativo a meno che non venga chiamata in un thread che attualmente non esegue la manutenzione di una chiamata RPC.
Commenti
RpcServerInqBindingHandle viene usato per ottenere l'handle di associazione per la chiamata RPC attualmente in esecuzione nel thread da cui viene chiamata anche questa API. Poiché molte API RPC richiedono un handle di associazione come input, questo è un modo pratico per ottenere un handle di associazione.
Si noti che tutte le API RPC lato server che accettano un handle di associazione come parametro consentono di passare NULL come valore accettato. Il passaggio di NULL anziché un handle di associazione indica che è necessario usare l'handle di associazione per la chiamata RPC attualmente in esecuzione nello stesso thread. Tuttavia, se si chiama un'API lato server da un thread separato, sarà necessario fornire un handle di associazione non NULL.
Se si usano handle di associazione espliciti e non si usano handle di contesto specifici del thread, l'handle di associazione per la chiamata è il primo parametro della routine di server manager. Tuttavia, se non si usano handle espliciti o se si usano handle di contesto, RpcServerInqBindingHandle è l'unico modo per ottenere un handle di associazione da usare in un altro thread.
Questa API può essere usata sia per le chiamate asincrone che per le chiamate sincrone, anche se è meno utile per le chiamate asincrone, poiché l'handle di associazione può essere ottenuto come stato asincrono è sempre il primo parametro per tutte le chiamate RPC asincrone e l'handle di associazione può essere ottenuto direttamente da esso usando RpcAsyncGetCallHandle.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | rpcdce.h (include Rpc.h) |
| Libreria | Rpcrt4.lib |
| DLL | Rpcrt4.dll |