Возвращаемые значения
Возвращается указатель на список идентификаторов элементов, который определяет местоположение выбранной папки относительно корня пространства имен. Если пользователь в диалоговом окне нажал клавишу Cancel, возвращается NULL .
Вызывающее приложение ответственно за освобождение возвращаемого списка идентификаторов.
См. также
BROWSEINFO.
Выполняет операцию копирования, перемещения, переименования или удаления над объектом файловой системы.
WINSHELLAPI int WINAPI SHFileOperation(
LPSHFILEOPSTRUCT lpFileOp
);
Параметры
lpFileOp - указатель на структуру типа SHFILEOPSTRUCT, содержащую информацию, необходимую функции для выполнения операции.
Возвращаемые значения
В случае успеха возвращается нуль, ненулевое значение в противном случае.
См. также
SHFILEOPSTRUCT.
Освобождает объект отображения имени файла (filename mapping object), извлекаемый функцией SHFileOperation.
WINSHELLAPI void WINAPI SHFreeNameMappings(
HANDLE hNameMappings
);
Параметры
hNameMappings - дескриптор освобождаемого объекта отображения имени файла.
Возвращаемые значения
Функция не возвращает значения.
Функция SHGetDesktopFolderвозвращает интерфейс IShellFolderдля папки рабочего стола, которая является корнем пространства имен пользовательского интерфейса ( shell ).
WINSHELLAPI HRESULT WINAPI SHGetDesktopFolder(
LPSHELLFOLDER *ppshf
);
Параметры
ppshf - адрес, получающий указатель на интерфейс IShellFolderдля папки рабочего стола. Вызывающее приложение ответственно за освобождение интерфейса вызовом метода Release.
Возвращаемые значения
В случае успеха возвращает NOERROR или OLE -определенную ошибку в противном случае.
См. также
IShellFolder.
Функция SHGetInstanceExplorerизвлекает адрес интерфейса IUnknownExplorer'а ( Проводника ).
WINSHELLAPI HRESULT WINAPI SHGetInstanceExplorer(
IUnknown* ppunk
);
Параметры
ppunk - указатель на переменную, получающую адрес интерфейса IUnknownExplorer 'а.
Возвращаемые значения
В случае успеха возвращается NOERROR .
В случае неудачи возвращается E _ FAIL .
Функция SHGetMallocизвлекает указатель на интерфейс IMallocоболочки. Расширение оболочки должно использовать этот интерфейс для выделения памяти, позднее освобождаемой оболочкой.
HRESULT SHGetMalloc(
LPMALLOC* ppMalloc
);
Параметры
ppMalloc - адрес переменной, которая получает адрес интерфейса IMallocоболочки.
Возвращаемые значения
В случае успеха возвращается NOERROR или E _ FAIL в противном случае.
Функция SHLoadInProcсоздает экземпляр указанного класса объекта внутри контекста процесса пользовательского интерфейса.
WINSHELLAPI HRESULT WINAPI SHLoadInProc(
REFCLSID rclsid
);
Параметры
rclsid - CLSID класса объекта, экземпляр которого создается.
Возвращаемые значения
В случае успеха возвращает NOERROR или OLE -определенную ошибку в противном случае.
Функция CancelDCотменяет любую незаконченную операцию на указанном контексте устройства.
BOOL CancelDC(
HDC hdc // дескриптор контекста устройства
);
Параметры
hdc - идентифицирует контекст устройства.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
Комментарии
Функция CancelDCиспользуется многопоточными приложениями для отмены протяженных во времени операций рисования. Если поток A инициирует такую операцию рисования, поток В может ее отменить, вызвав эту функцию.
Результаты не определены, если во время вызова этой функции не было выполняющейся операции рисования.
См. также
CreateThread, GetCurrentThread.
Функция CreateCompatibleDCсоздает контекст устройства в памяти, совместимый с указанный контекстом.
HDC CreateCompatibleDC(
HDC hdc // дескриптор контекста устройства
);
Параметры
hdc - идентифицирует контекст устройства. Если значение этого параметра равно NULL, функция создает контекст устройства в памяти, совместимый с текущим экраном приложения.
Читать дальше