RpcMgmtEpEltInqNext function

The RpcMgmtEpEltInqNext function returns one element from an endpoint map.

Syntax

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.

Return value

Remarks

The RpcMgmtEpEltInqNext function returns one element from the endpoint map. Elements selected depend on the inquiry context. The selection criteria are determined by InquiryType of the RpcMgmtEpEltInqBegin function 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 function 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 function. The application is responsible for calling RpcBindingFree for each returned Binding and RpcStringFree for each returned Annotation.

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

Requirements

See also

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone