RASMONITORDLG
[New
- Windows NT]
The RASMONITORDLG
structure is used in the RasMonitorDlg function to specify additional input and output
parameters.
typedef struct tagRASMONITORDLG {
IN DWORD dwSize;
IN HWND
hwndOwner;
IN DWORD dwFlags;
IN DWORD dwStartPage;
IN LONG
xDlg;
IN LONG
yDlg;
OUT DWORD
dwError;
IN DWORD reserved;
IN DWORD reserved2;
} RASMONITORDLG;
Members
dwSize
Specifies the
size of this structure, in bytes. Before calling RasMonitorDlg, set this
member to sizeof(RASMONITORDLG) to indicate the version of the
structure. If dwSize is not a valid size, RasMonitorDlg fails and
sets the dwError member to ERROR_INVALID_SIZE.
hwndOwner
Identifies
the window that owns the modal RasMonitorDlg property sheet. This member
can be any valid window handle, or it can be NULL if the property sheet has no
owner.
dwFlags
A bit flag
that indicates the options that are enabled for the property sheet. You can
specify the following value.
|
Value |
Meaning |
|
RASMDFLAG_PositionDlg
|
Causes RasMonitorDlg to use 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. |
dwStartPage
A set of bit
flags that indicate the initial page of the property sheet to display on top.
You can specify one of the following values.
|
Value |
Meaning |
|
RASMDPAGE_Status |
Display the
Status page on top. This is the default. |
|
RASMDPAGE_Summary |
Display the
Summary page on top. |
|
RASMDPAGE_Preferences |
Display the
Preferences page on top. |
xDlg
Specifies the
horizontal screen coordinate of the upper-left corner of the property sheet.
This value is used only if the RASMDFLAG_PositionDlg flag is set.
yDlg
Specifies the
vertical screen coordinate of the upper-left corner of the property sheet. This
value is used only if the RASMDFLAG_PositionDlg flag is set.
dwError
The RasMonitorDlg
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