Функция 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 оболочки. Расширение оболочки должно использовать этот интерфейс для выделения памяти, позднее освобождаемой оболочкой.
HRESULT SHGetMalloc (
LPMALLOC * ppMalloc
);
Параметры
ppMalloc - адрес переменной, которая получает адрес интерфейса IMalloc оболочки.
Возвращаемые значения
В случае успеха возвращается NOERROR или E _ FAIL в противном случае.
SHLoadInProc
Функция SHLoadInProc создает экземпляр указанного класса объекта внутри контекста процесса пользовательского интерфейса.
WINSHELLAPI HRESULT WINAPI SHLoadInProc (
REFCLSID rclsid
);
Параметры
rclsid - CLSID класса объекта, экземпляр которого создается.
Возвращаемые значения
В случае успеха возвращает NOERROR или OLE -определенную ошибку в противном случае.
Контекст устройства
CancelDC
Функция CancelDC отменяет любую незаконченную операцию на указанном контексте устройства.
BOOL CancelDC (
HDC hdc // дескриптор контекста устройства
);
Параметры
hdc - идентифицирует контекст устройства.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
Комментарии
Функция CancelDC используется многопоточными приложениями для отмены протяженных во времени операций рисования. Если поток A инициирует такую операцию рисования, поток В может ее отменить, вызвав эту функцию.
Результаты не определены, если во время вызова этой функции не было выполняющейся операции рисования.
См. также
CreateThread, GetCurrentThread .
CreateCompatibleDC
Функция CreateCompatibleDC создает контекст устройства в памяти, совместимый с указанный контекстом.
HDC CreateCompatibleDC (
HDC hdc // дескриптор контекста устройства
);
Параметры
hdc - идентифицирует контекст устройства. Если значение этого параметра равно NULL, функция создает контекст устройства в памяти, совместимый с текущим экраном приложения.
Возвращаемые значения
В случае успеха возвращается дескриптор контекста устройства в памяти.
В случае неудачи возвращается NULL .
Комментарии
Перед тем, как приложение сможет использовать контекст устройства в памяти для операций рисования, оно должно выбрать в контекст устройства битовый образ с корректной шириной и высотой. Как только битовый образ выбран, контекст устройства может быть использован для подготовки изображений, которые будут скопированы на экран или принтер.
Функция CreateCompatibleDC может быть использована только с теми устройствами, которые поддерживают растровые операции. Приложение может узнать о поддержке этих операций, вызвав функцию GetDeviceCaps .
В случае, если в контексте устройства отпала необходимость, вызовите функцию DeleteDC для его удаления.
См. также
CreateCompatibleBitmap, DeleteDC, GetDeviceCaps .
DeleteDC
Функция DeleteDC удаляет заданный контекст устройства.
BOOL DeleteDC (
HDC hdc // дескриптор контекста устройства
);
Параметры
hdc - идентифицирует контекст устройства.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
Комментарии
Приложение не должно удалять контекст устройства, чей дескриптор был получен вызовом функции GetDC . Вместо этого приложение должно вызвать функцию ReleaseDC для освобождения контекста устройства.
См. также
CreateDC, GetDC, ReleaseDC .
EnumObjects
Функция EnumObjects перечисляет перья или кисти, доступные для указанного контекста устройства. Эта функция вызывает определяемую приложением функцию обратного вызова один раз для каждого их доступных объектов, предоставляя данные, описывающие объект. EnumObjects продолжает вызывать функцию обратного вызова до тех пор, пока она не вернет нуль или не будут перечислены все доступные объекты.
int EnumObjects (
HDC hdc , // дескриптор контекста устройства
int nObjectType , // идентификатор типа объекта
GOBJENUMPROC lpObjectFunc , // указатель на функцию обратного вызова