Expand Minimize

RpcServerInterfaceGroupInqBindings function

The RpcServerInterfaceGroupInqBindings function returns the binding handles over which remote procedure calls can be received for the given interface group.

Syntax


RPC_STATUS WINAPI RpcServerInterfaceGroupInqBindings(
  _In_   RPC_INTERFACE_GROUP IfGroup,
  _Out_  RPC_BINDING_VECTOR *BindingVector
);

Parameters

IfGroup [in]

A RPC_INTERFACE_GROUP from RpcServerInterfaceGroupCreate that defines the interface group for which the bindings should be queried.

BindingVector [out]

Returns a pointer to a pointer to a vector of server binding handles.

Return value

ValueMeaning
RPC_S_OK

The call succeeded.

RPC_S_NO_BINDINGS

There are no bindings.

 

Note  For a list of valid error codes, see RPC Return Values.

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_BINDINGSand BindingVector is NULL. The server is responsible for calling RpcBindingVectorFree to release the vector's memory.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Rpcdce.h (include Rpc.h)

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

See also

RpcServerInterfaceGroupActivate
RpcServerInterfaceGroupClose
RpcServerInterfaceGroupCreate
RpcServerInterfaceGroupDeactivate

 

 

Community Additions

ADD
Show:
© 2014 Microsoft