On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

SHFILEOPSTRUCT

Contains information that the SHFileOperation function uses to perform file operations.

typedef struct _SHFILEOPSTRUCT { // shfos
HWND hwnd;
UINT wFunc;
LPCSTR pFrom;
LPCSTR pTo;
FILEOP_FLAGS fFlags;
BOOL fAnyOperationsAborted;
LPVOID hNameMappings;
LPCSTR lpszProgressTitle;
} SHFILEOPSTRUCT, FAR *LPSHFILEOPSTRUCT;

Members

hwnd

Handle of the dialog box to use to display information about the status of the operation.

wFunc

Operation to perform. This member can be one of the following values:

FO_COPY Copies the files specified by pFrom to the location specified by pTo.
FO_DELETE Deletes the files specified by pFrom (pTo is ignored).
FO_MOVE Moves the files specified by pFrom to the location specified by pTo.
FO_RENAME Renames the files specified by pFrom.

pFrom

Pointer to a buffer that specifies one or more source file names. Multiple names must be null-separated. The list of names must be double null-terminated.

pTo

Pointer to a buffer that contains the name of the destination file or directory. The buffer can contain mutiple destination file names if the fFlags member specifies FOF_MULTIDESTFILES. Multiple names must be null-separated. The list of names must be double null-terminated.

fFlags

Flags that control the file operation. This member can be a combination of the following values:

FOF_ALLOWUNDO Preserves undo information, if possible.
FOF_CONFIRMMOUSE Not implemented.
FOF_FILESONLY Performs the operation only on files if a wildcard filename (*.*) is specified.
FOF_MULTIDESTFILES Indicates that the pTo member specifies multiple destination files (one for each source file) rather than one directory where all source files are to be deposited.
FOF_NOCONFIRMATION Responds with "yes to all" for any dialog box that is displayed.
FOF_NOCONFIRMMKDIR Does not confirm the creation of a new directory if the operation requires one to be created.
FOF_RENAMEONCOLLISION Gives the file being operated on a new name (such as "Copy #1 of...") in a move, copy, or rename operation if a file of the target name already exists.
FOF_SILENT Does not display a progress dialog box.
FOF_SIMPLEPROGRESS Displays a progress dialog box, but does not show the filenames.
FOF_WANTMAPPINGHANDLE Fills in the hNameMappings member. The handle must be freed by using the SHFreeNameMappings function.

fAnyOperationsAborted

Value that receives TRUE if the user aborted any file operations before they were completed or FALSE otherwise.

hNameMappings

Handle of a filename mapping object that contains an array of SHNAMEMAPPING structures. Each structure contains the old and new path names for each file that was moved, copied, or renamed. This member is used only if fFlags includes FOF_WANTMAPPINGHANDLE.

lpszProgressTitle

Pointer to a string to use as the title for a progress dialog box. This member is used only if fFlags includes FOF_SIMPLEPROGRESS.

Remarks

If pFrom or pTo are unqualified names, the current directories are taken from the global current drive and directory settings as managed by the GetCurrentDirectory and SetCurrentDirectory functions.

See Also

GetCurrentDirectory, SetCurrentDirectory, SHFileOperation, SHFreeNameMappings, SHNAMEMAPPING

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

SHFILEOPSTRUCT

Содержит информацию, которую функция SHFileOperation использует, чтобы выполнять файловые операции.

typedef struct _SHFILEOPSTRUCT { // shfos HWND hwnd;
UINT wFunc;
LPCSTR pFrom;
LPCSTR pTo;
FILEOP_FLAGS fFlags;
BOOL fAnyOperationsAborted;
LPVOID hNameMappings;
LPCSTR lpszProgressTitle;
} SHFILEOPSTRUCT, ЗНАЧИТЕЛЬНО *LPSHFILEOPSTRUCT;

Участники

hwnd

Прооперируйте диалогового блока, чтобы использоваться, чтобы отображать информацию о статусе операции.

wFunc

Операция, чтобы выполняться. Этот элемент может быть одним из следующего величин:

FO_COPY Копирует файлы определенные pFrom в позицию определенную pTo.
FO_DELETE Удаляет файлы определенные pFrom (pTo проигнорирован).
FO_MOVE Перемещает файлы определенные pFrom в позицию определенную pTo.
FO_RENAME Переименовывает файлы определенные pFrom.

pFrom

Указатель в буфер, который определяет одно или более исходных файловых имен. Многочисленные имена должны быть недействительный разделенными. Список имен должен быть двойным количеством недействительный расторгнутым.

pTo

Указатель в буфер, который содержит имя файла расположения или директория. Буфер может содержать mutiple файловые имена расположения если элемент fFlags определяет FOF_MULTIDESTFILES. Многочисленные имена должны быть недействительный разделенными. Список имен должен быть двойным количеством недействительный расторгнутым.

fFlags

Флаги, что управлять файловой операцией. Этот элемент может быть комбинацией следующего величин:

FOF_ALLOWUNDO Сохраняет информацию отмены, если возможно.
FOF_CONFIRMMOUSE Не осуществлен.
FOF_FILESONLY Выполняет операцию только в файлах если шаблон filename (*.*), определен.
FOF_MULTIDESTFILES Указывает, что элемент pTo определяет многочисленным файлам расположения (за каждого исходного файла) а не один директорий где все исходные файлы должны быть депонированы.
FOF_NOCONFIRMATION Указывает "да им" для любого диалогового блока, который отображен.
FOF_NOCONFIRMMKDIR не подтверждает создание нового директория если операция требует один, чтобы быть созданн.
FOF_RENAMEONCOLLISION Дает файл, обслуживанный в новом имени (как например, "Копия #1...") на перемещении, копии или переименовывать операцию если файл целевого имени уже существует.
FOF_SILENT не отображает диалогового блока прогресса.
FOF_SIMPLEPROGRESS Отображает диалогового блока прогресса, но не показывает filenames.
FOF_WANTMAPPINGHANDLE Заполняет элемент hNameMappings. Ручка должна быть освобождена использованием функции SHFreeNameMappings.

fAnyOperationsAborted

Величина, которая получает ИСТИНУ если пользователь прерывал бы любые файловые операции прежде, чем они были завершены или ЛОЖЬ в противном случае.

hNameMappings

Прооперируйте filename, отображающий объект, что содержит массив структур SHNAMEMAPPING. Каждая структура содержится, старый и новый путь называет в честь каждого файла, который был перемещен, скопирован, или переименован. Этот элемент используется только если fFlags включает FOF_WANTMAPPINGHANDLE.

lpszProgressTitle

Указатель в строку, чтобы использовать как название для диалогового блока прогресса. Этот элемент используется только если fFlags включает FOF_SIMPLEPROGRESS.

Замечания

Если pFrom или pTo - неквалифицированные имена, текущие директории взяты из глобального текущего накопителя и установочных параметров директория как управлялось GetCurrentDirectory и функциями SetCurrentDirectory.

Смотри Также

GetCurrentDirectory, SetCurrentDirectory, SHFileOperation, SHFreeNameMappings, SHNAMEMAPPING

Используются технологии uCoz