CmGetFirstIpAddr (Compact 7)

3/12/2014

This function gets the first address associated with the specified destination host.

Syntax

CM_RESULT CmGetFirstIpAddr(
    __in CM_CONNECTION_HANDLE hConnection,
    __in const WCHAR* pszHost,
    __in ADDRESS_FAMILY AddrFamily,
    __in USHORT SrcPort,
    __in USHORT DstPort,
    __inout_bcount(*pcbAddressPair) CM_ADDRESS_PAIR* pAddressPair,
      __inout DWORD* pcbAddressPair
);

Parameters

• hConnection
  [in] A CM_CONNECTION_HANDLE value.

• pszHost
  [in] A pointer to a string value specifying the destination host name or IP address.

  Delimit a name with quotes. For example: "www.microsoft.com". A "*" in the leftmost label of the name will match all FQDN names in the domain. For example: "*.microsoft.com" matches "www.microsoft.com" and "msdn.microsoft.com".

  Delimit an IP address with quotes and square brackets. For example: "[207.46.19.254]". A "/" and a prefix length is used to define a CIDR block of addresses. For example: "[207.46.19.0/24]" or "[2001:0db8:1234::/48]".

• AddrFamily
  [in] An ADDRESS_FAMILY value in host byte order. These values are found in the Ws2def.h header file.

• SrcPort
  [in] The port number of the source of the connection.

• DstPort
  [in] The port number of the destination of the connection.

• 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

Requirements

See Also

Reference

Connection Manager Connectivity Functions
CM_ADDRESS_PAIR
CM_CONNECTION_HANDLE