Русский справочник по Win32 API
Шрифт:
SHAddToRecentDocs
Добавляет документ в список недавно использовавшихся документов или очищает список. Пользователь может получить доступ к списку через меню Пуск ( Start ) панели задач Windows .
WINSHELLAPI void WINAPI SHAddToRecentDocs (
UINT uFlags ,
LPCVOID pv
);
Параметры
uFlags–
SHARD_PATH - pv является адресом строки, содержащей путь и имя файла;
SHARD_PIDL - pv является адресом списка идентификаторов элемента.
pv– указатель на буфер, содержащий путь и имя файла документа, или адрес структуры ITEMIDLIST , содержащей список идентификаторов элемента, однозначно определяющих документ. Если значение этого параметр равно NULL, то функция очищает список недавно использовавшихся документов.
Возвращаемые значения
Функция не возвращает значения.
SHBrowseForFolder
Функция SHBrowseForFolder отображает диалоговое окно, позволяющее пользователю выбрать папку пространства имен.
WINSHELLAPI LPITEMIDLIST WINAPI SHBrowseForFolder (
LPBROWSEINFO lpbi
);
Параметры
lpbi– указатель на структуру типа BROWSEINFO , которая содержит информацию, используемую для отображения диалогового окна.
Возвращаемые значения
Возвращается указатель на список идентификаторов элементов, который определяет местоположение выбранной папки относительно корня пространства имен. Если пользователь в диалоговом окне нажал клавишу Cancel, возвращается NULL .
Вызывающее приложение ответственно за освобождение возвращаемого списка идентификаторов.
См. также
BROWSEINFO.
SHFileOperation
Выполняет операцию копирования, перемещения, переименования или удаления над объектом файловой системы.
WINSHELLAPI int WINAPI SHFileOperation (
LPSHFILEOPSTRUCT lpFileOp
);
Параметры
lpFileOp– указатель на структуру типа SHFILEOPSTRUCT , содержащую информацию, необходимую функции для выполнения операции.
Возвращаемые значения
В случае успеха возвращается нуль, ненулевое значение в противном случае.
См. также
SHFILEOPSTRUCT.
SHFreeNameMappings
Освобождает
объект отображения имени файла (filename mapping object), извлекаемый функцией SHFileOperation .WINSHELLAPI void WINAPI SHFreeNameMappings (
HANDLE hNameMappings
);
Параметры
hNameMappings– дескриптор освобождаемого объекта отображения имени файла.
Возвращаемые значения
Функция не возвращает значения.
SHGetDesktopFolder
Функция SHGetDesktopFolder возвращает интерфейс IShellFolder для папки рабочего стола, которая является корнем пространства имен пользовательского интерфейса ( shell ).
WINSHELLAPI HRESULT WINAPI SHGetDesktopFolder (
LPSHELLFOLDER *ppshf
);
Параметры
ppshf– адрес, получающий указатель на интерфейс IShellFolder для папки рабочего стола. Вызывающее приложение ответственно за освобождение интерфейса вызовом метода Release .
Возвращаемые значения
В случае успеха возвращает NOERROR или OLE -определенную ошибку в противном случае.
См. также
IShellFolder .
SHGetInstanceExplorer
Функция SHGetInstanceExplorer извлекает адрес интерфейса IUnknown Explorer'а ( Проводника ).
WINSHELLAPI HRESULT WINAPI SHGetInstanceExplorer (
IUnknown * ppunk
);
Параметры
ppunk– указатель на переменную, получающую адрес интерфейса IUnknown Explorer 'а.
Возвращаемые значения
В случае успеха возвращается NOERROR .
В случае неудачи возвращается E _ FAIL .
SHGetMalloc
Функция SHGetMalloc извлекает указатель на интерфейс IMalloc оболочки. Расширение оболочки должно использовать этот интерфейс для выделения памяти, позднее освобождаемой оболочкой.