RpcServerInqBindingHandle, fonction (rpcdce.h)
La fonction RpcServerInqBindingHandle obtient le handle de liaison pour les appels RPC gérés par le thread dans lequel RpcServerInqBindingHandle est appelé.
Syntaxe
RPC_STATUS RpcServerInqBindingHandle(
RPC_BINDING_HANDLE *Binding
);
Paramètres
Binding
RPC_BINDING_HANDLE structure qui, en cas de réussite, reçoit le handle de liaison pour l’appel traité par le thread sur lequel RpcServerInqBindingHandle est également appelé.
Si l’appel échoue, ce paramètre n’est pas défini.
Valeur retournée
Cette fonction retourne RPC_S_OK en cas de réussite ; sinon, un code d’erreur RPC_S_* est retourné. Cette fonction ne peut pas échouer, sauf si elle est appelée sur un thread qui ne traite pas actuellement un appel RPC.
Notes
RpcServerInqBindingHandle permet d’obtenir le handle de liaison pour l’appel RPC en cours d’exécution sur le thread à partir duquel cette API est également appelée. Étant donné que de nombreuses API RPC nécessitent un handle de liaison comme entrée, il s’agit d’un moyen pratique d’obtenir un handle de liaison.
Notez que toutes les API RPC côté serveur qui prennent un handle de liaison en tant que paramètre vous permettent de passer NULL en tant que valeur acceptée. Le passage de null au lieu d’un handle de liaison indique que le handle de liaison pour l’appel RPC en cours d’exécution dans le même thread doit être utilisé. Toutefois, si vous appelez une API côté serveur à partir d’un thread distinct, vous devez leur fournir un handle de liaison non NULL.
Si vous utilisez des handles de liaison explicites et que vous n’utilisez pas de handles de contexte spécifiques au thread, le handle de liaison pour l’appel est le premier paramètre de votre routine de gestionnaire de serveur. Toutefois, si vous n’utilisez pas de handles explicites ou si vous utilisez des handles de contexte, RpcServerInqBindingHandle est le seul moyen d’obtenir un handle de liaison à utiliser dans un autre thread.
Cette API peut être utilisée pour les appels asynchrones et synchrones, bien qu’elle soit moins utile pour les appels asynchrones, car le handle de liaison peut être obtenu car l’état async est toujours le premier paramètre pour tous les appels RPC asynchrones et le handle de liaison peut être obtenu directement à partir de celui-ci à l’aide de RpcAsyncGetCallHandle.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | rpcdce.h (inclure Rpc.h) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |