RASDIALDLG

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.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in rasdlg.h.
  Import Library: Use rasdlg.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Remote Access Service Overview, RAS Server Administration Union, RasDialDlg