RasEnumAutodialAddresses

[New - Windows NT]

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.

Value Meaning
ERROR_INVALID_PARAMETER NULL was passed for the lpdwcbAddresses or lpdwcAddresses parameter.

See Also

RASAUTODIALENTRY, RasGetAutodialAddress, RasSetAutodialAddress