CmGetNextIpAddr (Compact 7)
3/12/2014
This function gets the next address associated with the specified destination host.
Syntax
CM_RESULT CmGetNextIpAddr(
__in CM_CONNECTION_HANDLE hConnection,
__inout_bcount(*pcbAddressPair) CM_ADDRESS_PAIR* pAddressPair,
__inout DWORD* pcbAddressPair
);
Parameters
- hConnection
[in] A CM_CONNECTION_HANDLE value.
pAddressPair
[in] A pointer to a storage area to place the output.[out] A pointer to a set of CM_ADDRESS_PAIR structures.
pcbAddressPair
[in] A pointer to a storage area to place the output.[out] A pointer to the count of structures in pAddressPair.
Return Value
| Value | Description |
|---|---|
CMRE_SUCCESS |
The operation completed successfully. |
CMRE_INVALID_CONNECTION |
The name of the connection is not valid. |
CMRE_HOST_ADDRESS_ITERATION_NOT_STARTED |
Host address iteration has not been started with CmGetFirstIpAddr. |
CMRE_NO_HOST_ADDRESSES |
The host name could not be resolved using the connection. |
CMRE_INSUFFICIENT_BUFFER |
The pAddressPair output buffer is too small to contain the address pair. The required output buffer size is returned in pcbAddressPair. |
CMRE_INVALID_VERSION |
The version of the pAddressPair is not supported. |
CMRE_UNEXPECTED |
An unexpected failure occurred. |
Remarks
When called repetitively, this function iterates through all the addresses.
This function requires that you first call CmGetFirstIpAddr.
Requirements
Header |
cmnet.h |
Library |
cmnet.lib |
See Also
Reference
Connection Manager Connectivity Functions
CM_ADDRESS_PAIR
CM_CONNECTION_HANDLE
CmGetFirstIpAddr