RpcMgmtEpEltInqNext

The RpcMgmtEpEltInqNext function returns one element from an endpoint map.

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

#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcMgmtEpEltInqNext( 
  RPC_EP_INQ_HANDLE  InquiryContext,   
  RPC_IF_ID * IfId,                    
  RPC_BINDING_HANDLE * Binding,        
  UUID *  ObjectUuid,                  
  unsigned char * *  Annotation        
);
 

Parameters

InquiryContext

Specifies an inquiry context. The inquiry context is returned from RpcMgmtEpEltInqBegin.

IfId

Returns the interface identifier of the endpoint map element.

Binding

Optional. Returns the binding handle from the endpoint map element.

ObjectUuid

Optional. Returns the object UUID from the endpoint map element.

Annotation

Optional. Returns the annotation string for the endpoint map element. When there is no annotation string in the endpoint map element, the empty string ("") is returned.

Remarks

The RpcMgmtEpEltInqNext routine returns one element from the endpoint map. Elements selected depend on the inquiry context. The selection criteria are determined by InquiryType of the RpcMgmtEpEltInqBegin routine that returned InquiryContext.

An application can view all the selected endpoint map elements by repeatedly calling RpcMgmtEpEltInqNext. When all the elements have been viewed, this routine returns an RPC_X_NO_MORE_ENTRIES status. The returned elements are unordered.

When the respective arguments are non-NULL, the RPC run-time function library allocates memory for Binding and Annotation on each call to this routine. The application is responsible for calling RpcBindingFree for each returned Binding and RpcStringFree for each returned Annotation.

After viewing the endpoint map's elements, the application must call RpcMgmtEpEltInqDone to delete the inquiry context.

Return Values

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcdce.h.
  Import Library: Link with rpcrt4.lib.

See Also

RpcEpRegister