# AddToFilePopupDirHistory

int AddToFilePopupDirHistory (char *directoryPathname);

## Purpose

Inserts a directory pathname into the directory history list that appears in the dialog boxes you can display with the FileSelectPopup, MultiFileSelectPopup, and the DirSelectPopup functions.

The directory history list can hold up to a maximum of 15 directory pathnames. The first entry in the list is always the pathname of the directory that the dialog box is currently displaying.

## Parameters

Input
Name | Type | Description
directoryPathname | char * | The directory name you want to insert into the directory history list that appears in the dialog boxes you can display with the FileSelectPopup, MultiFileSelectPopup, and the DirSelectPopup functions. Pass the absolute pathname of a directory, including the drive letter; for example d:\myapps\simptest. The function does not check the validity of the pathname. The function adds the pathmame to the directory history even if pathname is invalid or does not exist on disk. You can pass NULL or an empty string, in which case function has no effect.

## Return Value

Name | Type | Description
status | integer | Return value indicating whether the function was successful. A negative number indicates that an error occurred.
Code | Error Message String
xx | Success