Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

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

ValueMeaning
RPC_S_OK

The call succeeded.

 

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

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcdce.h (include Rpc.h)

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

Unicode and ANSI names

RpcMgmtEpEltInqNextW (Unicode) and RpcMgmtEpEltInqNextA (ANSI)

See also

RpcEpRegister
RpcMgmtEpEltInqBegin
RpcMgmtEpEltInqDone

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.