Share via


RASDIALDLG structure

The RASDIALDLG structure is used in the RasDialDlg function to specify additional input and output parameters.

Syntax

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  ULONG_PTR reserved;
  IN  ULONG_PTR 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
    Specifies 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. The following value is supported..

    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
    Specifies 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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rasdlg.h

See also

Remote Access Service (RAS) Overview

Remote Access Service Structures

RasDialDlg