RpcServerInqBindings  1KWSMMK

The RpcServerInqBindings function returns the binding handles over which remote procedure calls can be received.

This function is supported by both 32-bit platforms   Windows NT and Windows 95.

#include <rpc.h>

RPC_STATUS RPC_ENTRY RpcServerInqBindings(

Parameters

BindingVector

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

Remarks

A server application calls the RpcServerInqBindings routine to obtain a vector of server binding handles. Binding handles are created by the RPC run-time library when a server application calls the following routines to register protocol sequences:

    RpcServerUseAllProtseqs

    RpcServerUseProtseq

    RpcServerUseAllProtseqsIf

    RpcServerUseProtseqIf

    RpcServerUseProtseqEp

The returned binding vector can contain binding handles with dynamic endpoints or binding handles with well-known endpoints, depending on which of the above routines the server application called.

A server uses the vector of binding handles for exporting to the name service, for registering with the local endpoint-map database, or for conversion to string bindings.

If there are no binding handles (no registered protocol sequences), this routine returns the RPC_S_NO_BINDINGS status code and a BindingVector argument value of NULL.

The server is responsible for calling the RpcBindingVectorFree routine to release the memory used by the vector.

Return Values

See Also