Platform SDK: RAS/Routing and RAS |
The RasGetAutodialAddress function retrieves information about all the AutoDial entries associated with a network address in the AutoDial mapping database.
DWORD RasGetAutodialAddress( LPCTSTR lpszAddress, // pointer to a network address string LPDWORD lpdwReserved, // reserved; must be NULL LPRASAUTODIALENTRY lpAutoDialEntries, // pointer to buffer for AutoDial entry data LPDWORD lpdwcbAutoDialEntries, // pointer to size, in bytes, of buffer LPDWORD lpdwcAutoDialEntries // pointer to number of entries returned );
sizeof(RASAUTODIALENTRY)
to identify the version of the structure.
If lpAutoDialEntries is NULL, RasGetAutodialAddress sets the lpdwcbAutoDialEntries and lpdwcAutoDialEntries parameters to indicate the required buffer size, in bytes, and the number of AutoDial entries.
If the function succeeds, the return value is zero.
If the function fails, the return value is one of the following error codes.
Value | Meaning |
---|---|
ERROR_XXX_NOT_FOUND | The address was not found in the mapping database. |
ERROR_INVALID_SIZE | The dwSize member of the RASAUTODIALENTRY structure is an invalid value. |
ERROR_INVALID_PARAMETER | The lpszAddress, lpdwcbAutoDialEntries, or lpdwcAutoDialEntries parameter was NULL. |
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.
Remote Access Service (RAS) Overview, Remote Access Service Functions, RASAUTODIALENTRY, RasEnumAutodialAddresses, RasSetAutodialAddress