RASDIALDLG
[New
- Windows NT]
The RASDIALDLG
structure is used in the RasDialDlg function to specify additional input and
output parameters.
typedef struct tagRASDIALDLG {
IN DWORD
dwSize;
IN HWND
hwndOwner;
IN DWORD
dwFlags;
IN LONG
xDlg;
IN LONG
yDlg;
IN DWORD
dwSubEntry;
OUT
DWORD dwError;
IN DWORD
reserved;
IN DWORD
reserved2;
} RASDIALDLG;
Members
dwSize
Specifies the
size of this structure, in bytes. Before calling RasDialDlg, set this member to sizeof(RASDIALDLG)
to indicate the version of the structure. If dwSize is not a valid size,
RasDialDlg fails and sets the dwError member to
ERROR_INVALID_SIZE.
hwndOwner
Identifies
the window that owns the modal RasDialDlg dialog boxes. This member can
be any valid window handle, or it can be NULL if the dialog box has no owner.
dwFlags
A bit flag
that indicates the options that are enabled for the dialog box. You can specify
the following value.
|
Value |
Meaning |
|
RASDDFLAG_PositionDlg
|
If this
flag is set, RasDialDlg
uses the values specified by the xDlg and yDlg members to
position the dialog box. If this
flag is not set, the dialog box is centered on the owner window, unless hwndOwner
is NULL, in which case, the dialog box is centered on the screen. |
xDlg
Specifies the
horizontal screen coordinate of the upper-left corner of the dialog box. This
value is used only if the RASDDFLAG_PositionDlg flag is set.
yDlg
Specifies the
vertical screen coordinate of the upper-left corner of the dialog box. This
value is used only if the RASDDFLAG_PositionDlg flag is set.
dwSubEntry
Indicates the
subentry or subentries to dial. If dwSubEntry is zero, RasDialDlg dials all subentries
associated with the specified phone-book entry. Otherwise, to indicate the
index of the individual subentry to dial, dwSubEntry must be a number
from one to the number of subentries.
dwError
The RasDialDlg
function sets this member to a system error code or RAS error code if an error
occurs. If no error occurs, the function sets dwError to zero. This
value is ignored on input.
reserved
Reserved;
must be zero.
reserved2
Reserved;
must be zero.
See Also