The RpcMgmtEpEltInqBegin function creates an inquiry context for viewing the elements in an endpoint map.
This function is supported by both 32-bit platforms — Windows NT and Windows 95.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcMgmtEpEltInqBegin(
RPC_BINDING_HANDLE EpBinding,
unsigned long InquiryType,
RPC_IF_ID * IfId,
unsigned long VersOption,
UUID * ObjectUuid,
RPC_EP_INQ_HANDLE * InquiryContext
);
Value | Description |
---|---|
RPC_C_EP_ALL_ELTS | Returns every element from the endpoint map. The IfId, VersOption, and ObjectUuid parameters are ignored. |
RPC_C_EP_MATCH_BY_IF | Searches the endpoint map for those elements that contain the interface identifier specified by the IfId and VersOption values. |
RPC_C_EP_MATCH_BY_OBJ | Searches the endpoint map for those elements that contain the object UUID specified by ObjectUuid. |
RPC_C_EP_MATCH_BY_BOTH | Searches the endpoint map for those elements that contain the interface identifier and object UUID specified by IfId, VersOption, and ObjectUuid. |
Value | Description |
---|---|
RPC_C_VERS_ALL | Returns endpoint map elements that offer the specified interface UUID, regardless of the version numbers. |
RPC_C_VERS_COMPATIBLE | Returns endpoint map elements that offer the same major version of the specified interface UUID and a minor version greater than or equal to the minor version of the specified interface UUID. |
RPC_C_VERS_EXACT | Returns endpoint map elements that offer the specified version of the specified interface UUID. |
RPC_C_VERS_MAJOR_ONLY | Returns endpoint map elements that offer the same major version of the specified interface UUID and ignores the minor version. |
RPC_C_VERS_UPTO | Returns endpoint map elements that offer a version of the specified interface UUID less than or equal to the specified major and minor version. |
The RpcMgmtEpEltInqBegin routine creates an inquiry context for viewing server address information stored in the endpoint map. Using InquiryType and VersOption, an application specifies which of the following endpoint map elements are to be returned from calls to RpcMgmtEpEltInqNext:
Before calling RpcMgmtEpEltInqNext, the application must first call this routine to create an inquiry context. After viewing the endpoint map elements, the application calls RpcMgmtEpEltInqDone to delete the inquiry context.
Value | Meaning |
---|---|
RPC_S_OK | Success |
Windows NT: Yes
Windows CE: Unsupported.
Header: Declared in rpcdce.h.
Import Library: Link with rpcrt4.lib.