SendARP

The SendARP function sends an ARP request to obtain the physical address that corresponds to the specified destination IP address.

DWORD SendARP(
  IPAddr DestIP,     // destination IP address
  IPAddr SrcIP,      // IP address of sender
  PULONG pMacAddr,   // returned physical address
  PULONG PhyAddrLen  // length of returned physical addr.
);

Parameters

DestIP

Specifies the destination IP address. The ARP request attempts to obtain the physical address that corresponds to this IP address.

SrcIP

Specifies the IP address of the sender. This parameter is optional. The caller may specify zero for the parameter.

pMacAddr

Pointer to a ULONG variable. On successful return, this variable contains the physical address that corresponds to the IP address specified by the DestIP parameter.

PhyAddrLen

Pointer to a ULONG variable. On successful return, this variable contains the length of the physical address pointed to by the pMacAddr parameter.

Return Values

If the function succeeds, the return value is NO_ERROR.

If the function fails, use FormatMessage to obtain the message string for the returned error.

Remarks

For information about the IPAddr data type, see Win32 Simple Data Types. To convert an IP address between dotted decimal notation and IPAddr format, use the inet_addr and inet_ntoa functions.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Iphlpapi.h.
  Library: Use Iphlpapi.lib.

See Also

CreateIpNetEntry, DeleteIpNetEntry, FlushIpNetTable, SetIpNetEntry