RpcServerInterfaceGroupInqBindings function (rpcdce.h)
The RpcServerInterfaceGroupInqBindings function returns the binding handles over which remote procedure calls can be received for the given interface group.
Syntax
RPC_STATUS RpcServerInterfaceGroupInqBindings(
[in] RPC_INTERFACE_GROUP IfGroup,
[out] RPC_BINDING_VECTOR **BindingVector
);
Parameters
[in] IfGroup
A RPC_INTERFACE_GROUP from RpcServerInterfaceGroupCreate that defines the interface group for which the bindings should be queried.
[out] BindingVector
Returns a pointer to a pointer to a vector of server binding handles.
Return value
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
There are no bindings. |
Remarks
A server application calls RpcServerInterfaceGroupInqBindings to obtain a vector of server binding handles for the given interface group. The RPC run-time library creates binding handles for an interface group when a server application calls the RpcServerInterfaceGroupActivate function.
The returned binding vector can contain binding handles with dynamic endpoints or binding handles with well-known endpoints, depending on the interface group’s endpoint specification.
A server uses the vector of binding handles for exporting to the name service or for conversion to string bindings. If there are no binding handles (no registered protocol sequences), RpcServerInterfaceGroupInqBindings returns RPC_S_NO_BINDINGS and BindingVector is NULL. The server is responsible for calling RpcBindingVectorFree to release the vector's memory.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps only] |
| Minimum supported server | Windows Server 2012 [desktop apps only] |
| Target Platform | Windows |
| Header | rpcdce.h (include Rpc.h) |
| Library | Rpcrt4.lib |
| DLL | Rpcrt4.dll |