CONNECTDLGSTRUCT

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure is used in the WNetConnectionDialog1 function to specify the browsing dialog box parameters.

Syntax

typedef struct {
  DWORD cbStructure;
  HWND hwndOwner;
  LPNETRESOURCE lpConnRes;
  DWORD dwFlags;
  DWORD dwDevNum;
} CONNECTDLGSTRUCT;

Members

• cbStructure
  Size of this structure, in bytes.

• hwndOwner
  Handle of the owning window.

• lpConnRes
  Long pointer to a null-terminated string that specifies the path of a network resource to connect to. If the lpRemoteName member of the NETRESOURCE structure is specified, this member is entered into the path field of the dialog box. All other members must be set to NULL except dwTypewhich specifies the type of resources of interest, and must be one of RESOURCETYPE_DISK.

• dwFlags
  Specifies variations in the dialog display. This member must be set to zero or the following value.

  Value	Description
  CONNDLG_RO_PATH	Instead of enabling the user to type in a path, have a read-only path already inserted. This flag should be set only if lpRemoteName is not NULL or an empty string.

• dwDevNum
  Unsupported.

Remarks

ERROR_SUCCESS indicates that the call is successful and displays the dialog. Typically, this function returns an error only if the dialog box could not be displayed because errors that occur after are reported directly to the user

The ERROR_INVALID_PARAMETER may mean that CONNDLG_RO_PATH is set and lpRemoteName does not point to a remote name.

Requirements

See Also

Reference

NETRESOURCE
WNetConnectionDialog1