Тарас Сорока - Русский справочник по Win32 API

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, функция создает контекст устройства в памяти, совместимый с текущим экраном приложения.

Возвращаемые значения

В случае успеха возвращается дескриптор контекста устройства в памяти.

В случае неудачи возвращается NULL .

Комментарии

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

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

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

См. также

CreateCompatibleBitmap, DeleteDC, GetDeviceCaps.

Функция DeleteDCудаляет заданный контекст устройства.

BOOL DeleteDC(

HDC hdc // дескриптор контекста устройства

);

Параметры

hdc - идентифицирует контекст устройства.

Возвращаемые значения

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль.

Комментарии

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

См. также

CreateDC, GetDC, ReleaseDC.

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

int EnumObjects(

HDC hdc , // дескриптор контекста устройства

int nObjectType , // идентификатор типа объекта

GOBJENUMPROC lpObjectFunc , // указатель на функцию обратного вызова

LPARAM lParam // указатель на предоставляемые приложением данные

);

Параметры

hdc - идентифицирует контекст устройства.

nObjectType - определяет тип объекта. Может принимать значение OBJ_BRUSH или OBJ_PEN .

lpObjectFunc - указатель на определяемую приложением функцию обратного вызова. Для дополнительной информации об этой функции смотрите описание функции EnumObjectsProc.

lParam - указывает на определяемые приложением данные. Данные передаются в функцию обратного вызова вместе с информацией об объекте.

Возвращаемые значения

Возвращаемое значение определяет последнее значение, возвращенное функцией обратного вызова. Его смысл определяется пользователем. Возвращается -1 в случае наличия слишком большого количества объектов, подлежащих перечислению. В этом случае функция обратного вызова не вызывается.

См. также

EnumObjectsProc, GetObject.

Функция GetDCизвлекает дескриптор контекста дисплея для клиентской области указанного окна. Контекст дисплея может быть использован в последующих функциях GDI для рисования в клиентской области окна.

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