RASSUBENTRY structure
The RASSUBENTRY structure contains information about a subentry of a RAS phone-book entry. The RasSetSubEntryProperties and RasGetSubEntryProperties functions use this structure to set and retrieve the properties of a subentry.
Syntax
typedef struct tagRASSUBENTRY {
DWORD dwSize;
DWORD dwfFlags;
TCHAR szDeviceType[RAS_MaxDeviceType + 1];
TCHAR szDeviceName[RAS_MaxDeviceName + 1];
TCHAR szLocalPhoneNumber[RAS_MaxPhoneNumber + 1];
DWORD dwAlternateOffset;
} RASSUBENTRY;
Members
dwSize
Specifies the size, in bytes, of the RASSUBENTRY structure. Before calling RasSetSubEntryProperties or RasGetSubEntryProperties, set dwSize to sizeof(RASSUBENTRY) to identify the version of the structure.dwfFlags
Currently unused. The RasSetSubEntryProperties function sets this member to zero. The RasGetSubEntryProperties function ignores this member.szDeviceType
Specifies a null-terminated string indicating the RAS device type referenced by szDeviceName. See RASENTRY for a list of possible device types.szDeviceName
Specifies a null-terminated string that contains the name of the TAPI device to use with this phone-book entry. To enumerate all available RAS-capable devices, use the RasEnumDevices function.szLocalPhoneNumber
Specifies a null-terminated string that contains a telephone number. RAS uses the szLocalPhoneNumber string as the entire phone number; the number includes any required country/region or area codes. See Dialable Addresses for more information on the format of dialable phone numbers.dwAlternateOffset
Specifies the offset, in bytes, from the beginning of the structure to a list of consecutive null-terminated strings. The last string is terminated by two consecutive null characters. The strings are alternate phone numbers that RAS dials in the order listed if the primary number (see szLocalPhoneNumber) fails to connect. The alternate phone number strings are ANSI or Unicode, depending on whether you use the ANSI or Unicode version of the structure.
Requirements
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
Minimum supported server |
Windows 2000 Server [desktop apps only] |
Header |
Ras.h |
Unicode and ANSI names |
RASSUBENTRYW (Unicode) and RASSUBENTRYA (ANSI) |
See also
Remote Access Service (RAS) Overview