RasEnumAutodialAddresses

The RasEnumAutodialAddresses function returns a list of all addresses in the AutoDial mapping database.

DWORD RasEnumAutodialAddresses(
  LPTSTR *lppAddresses,     // pointer to buffer that
                            //  receives network address strings
  LPDWORD lpdwcbAddresses,  // pointer to size, in bytes,
                            //  of the buffer
  LPDWORD lpdwcAddresses    // pointer to number of strings
                            //  returned
);

Parameters

lppAddresses

Pointer to an array of string pointers, with additional space for the storage of the strings themselves at the end of the buffer. Each string is the name of an address in the AutoDial mapping database.

If lppAddresses is NULL, RasEnumAutodialAddresses sets the lpdwcbAddresses and lpdwcAddresses parameters to indicate the required size, in bytes, and the number of address entries in the database.

lpdwcbAddresses

Pointer to a variable that contains the size, in bytes, of the buffer specified by the lppAddresses parameter. On return, the function sets this variable to the number of bytes returned, or the number of bytes required if the buffer is too small.

lpdwcAddresses

Pointer to a variable that receives the number of address strings returned in the lppAddresses buffer.

Return Values

If the function succeeds, the return value is zero.

If the function fails, the return value is the following error code.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Ras.h.
  Library: Use Rasapi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.

See Also

Remote Access Service (RAS) Overview, Remote Access Service Functions, RASAUTODIALENTRY, RasGetAutodialAddress, RasSetAutodialAddress