RASMONITORDLG structure

  • Article

[This function is not supported after Windows 2000.]

The RASMONITORDLG structure is used in the RasMonitorDlg function to specify additional input and output parameters.

Syntax

typedef struct tagRASMONITORDLG {
  DWORD     dwSize;
  HWND      hwndOwner;
  DWORD     dwFlags;
  DWORD     dwStartPage;
  LONG      xDlg;
  LONG      yDlg;
  OUT DWORD dwError;
  ULONG_PTR reserved;
  ULONG_PTR 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
    Specifies 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. 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. 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.

Requirements

End of client support

Windows 2000 Professional

End of server support

Windows 2000 Server

Header

 Rasdlg.h

See also

Remote Access Service (RAS) Overview

Remote Access Service Structures

RasMonitorDlg