Метод IDsDisplaySpecifier::GetIcon (dsclient.h)
Метод IDsDisplaySpecifier::GetIcon получает значок для заданного класса объекта.
Синтаксис
HICON GetIcon(
[in] LPCWSTR pszObjectClass,
[in] DWORD dwFlags,
[in] INT cxIcon,
[in] INT cyIcon
);
Параметры
[in] pszObjectClass
Указатель на строку Юникода, завершающуюся null, которая содержит имя класса объекта для получения значка. Примеры имени класса объекта: user и container.
[in] dwFlags
Содержит набор флагов, указывающих тип извлекаемого значка. Это может быть сочетание одного или нескольких из следующих значений.
DSGIF_ISNORMAL
Получает обычный значок для класса объекта.
DSGIF_ISOPEN
Получает значок открытия, например открытую папку, для класса объекта. Если у класса объектов нет открытого значка, этот метод пытается получить обычный значок для класса объекта.
DSGIF_ISDISABLED
Получает значок отключения, например отключенного пользователя, для класса объекта. Если у класса объектов нет отключенного значка, этот метод пытается получить обычный значок для класса объекта.
DSGIF_ISMASK
Используется для маскирования флагов DSGIF_ISNORMAL, DSGIF_ISOPEN и DSGIF_ISDISABLED .
DSGIF_GETDEFAULTICON
Если значок для класса объекта не найден, этот метод возвращает значок по умолчанию. Если этот флаг не указан и для класса объекта не найден значок, этот метод возвращает значение NULL.
DSGIF_DEFAULTISCONTAINER
Если значок для класса объекта не найден, этот метод возвращает значок контейнера в качестве значка по умолчанию. Если этот флаг не указан и для класса объекта не найден значок, этот метод возвращает значение NULL.
[in] cxIcon
Содержит нужную ширину значка в пикселях. Этот метод получает значок, который наиболее точно соответствует этой ширине.
[in] cyIcon
Содержит нужную высоту значка в пикселях. Этот метод получает значок, который наиболее точно соответствует этой высоте.
Возвращаемое значение
Возвращает дескриптор значка в случае успешного выполнения или значение NULL в противном случае. Вызывающий объект должен уничтожить этот значок, если он больше не требуется, передав этот дескриптор DestroyIcon.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | dsclient.h |
| DLL | Dsadmin.dll |