Share via

CmGetNextIpAddr (Compact 7)

  • Article

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

  • 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