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

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

See also

RpcServerInterfaceGroupActivate

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate