title

A string whose value is the title of
the dialog box.

pathname

A string variable in which you want to
store the returned path. If the user selects a single file, the pathname variable
contains the path name and file name.

filename, filename[ ]

A string variable in which the returned
file name is stored or an array of string variables in which multiple
selected file names are stored. Specifying an array of string variables
enables multiple selection in the dialog box.

extension (optional)

A string whose value is a 1- to 3-character
default file extension. The default is no extension.

filter (optional)

A string whose value is a text description
of the files to include in the list box and the file mask that you
want to use to select the displayed files (for example, *.* or *.exe).
The format for filter is:

To specify multiple filter patterns for a single display string,
use a semicolon to separate the patterns, for example:

The default is:

initdir (optional)

A string whose value is the initial directory
name. The default is the current directory.

aFlag (optional)

An unsigned long whose value determines
which options are enabled in the dialog box. The value of each option’s
flag is calculated as 2 to the power of (index -1),
where index is the integer associated with
the option. The value of the aggregate flag passed to GetFileOpenName is
the sum of the individual option flags. See the table in the Usage
section for a list of options, the index associated with each option,
and the option’s meaning.

1

OFN_CREATEPROMPT

If the specified file does not exist,
prompt for permission to create the file. If the user chooses to
create the file, the dialog box closes; otherwise the dialog box
remains open.

2

OFN_EXPLORER

Use an Explorer-style dialog box.

3

OFN_EXTENSIONDIFFERENT

The file extension entered differed from
the extensions specified in extension.

4

OFN_FILEMUSTEXIST

Only the names of existing files can
be entered.

5

OFN_HIDEREADONLY

Hide the Read Only check box.

6

OFN_LONGNAMES

Use long file names. Ignored for Explorer-style
dialog boxes.

7

OFN_NOCHANGEDIR

Restore the current directory to its
original value if the user changed the directory while searching
for files. This option has no effect for GetFileOpenName on
Windows NT, 2000, and XP.

8

OFN_NODEREFERENCELINKS

Return the path and file name of the
selected shortcut (.lnk file); otherwise the
path and file name pointed to by the shortcut are returned.

9

OFN_NOLONGNAMES

Use short file names (8.3 format). Ignored
for Explorer-style dialog boxes.

10

OFN_NONETWORKBUTTON

Hide the Network button. Ignored for
Explorer-style dialog boxes.

11

OFN_NOREADONLYRETURN

The file returned is not read only and
is not in a write-protected directory.

12

OFN_NOTESTFILECREATE

Do not create the file before the dialog
box is closed. This option should be specified if the application
saves the file on a netwrok share where files can be created but
not modified. No check is made for write protection, a full disk,
an open drive door, or network protection.

A file cannot be reopened once it is closed.

13

OFN_NOVALIDATE

Invalid characters are allowed in file
names.

14

OFN_OVERWRITEPROMPT

Used in Save As dialog boxes. Generates
a message box if the selected file already exists.

15

OFN_PATHMUSTEXIST

Only valid paths and file names can be
entered.

16

OFN_READONLY

Select the Read Only check box when the
Save dialog box is created.