Prev Next
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.
typedef struct tagRASSUBENTRY {
DWORD dwSize;
DWORD dwfFlags;
//
// Device
//
TCHAR szDeviceType[ RAS_MaxDeviceType + 1 ];
TCHAR szDeviceName[ RAS_MaxDeviceName + 1 ];
//
// Phone numbers
//
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. This member can be one of the following string
constants.
String
|
Description
|
RASDT_Modem
|
A modem accessed through a COM port.
|
RASDT_Isdn
|
An ISDN card with the corresponding NDISWAN driver installed.
|
RASDT_X25
|
An X.25 card with the corresponding NDISWAN driver installed.
|
-
szDeviceName
-
Specifies a null-terminated string containing 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 containing a telephone number. The way RAS
uses this string depends on whether the RASEO_UseCountryAndAreaCodes flag is
set in the dwfOptions member of the RASENTRY
structure for this phone-book entry. If the flag is set, RAS combines szLocalPhoneNumber
with the country and area codes specified in the RASENTRY structure. If
the flag is not set, RAS uses the szLocalPhoneNumber string as the
entire phone number.
-
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.
See Also
RasGetSubEntryProperties, RasSetSubEntryProperties
file: /Techref/os/win/api/win32/struc/src/str15_19.htm, 4KB, , updated: 2000/4/7 11:20, local time: 2024/12/13 07:39,
|
| ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://techref.massmind.org/techref/os/win/api/win32/struc/src/str15_19.htm"> RASSUBENTRY</A> |
Did you find what you needed?
|
|
Welcome to techref.massmind.org!
|
.