Русский справочник по Win32 API
Шрифт:
Возвращаемые значения
Функция не возвращает значения.
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 оболочки. Расширение оболочки должно использовать этот интерфейс для выделения памяти, позднее освобождаемой оболочкой.
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, функция создает контекст устройства в памяти, совместимый с текущим экраном приложения.
Возвращаемые значения
В случае успеха возвращается дескриптор контекста устройства в памяти.