Метод IDsDisplaySpecifier::GetIconLocation (dsclient.h)

Статья
08/23/2023

Метод IDsDisplaySpecifier::GetIconLocation получает расположение значка для заданного класса объекта. Расположение значка содержит имя файла и идентификатор ресурса.

Синтаксис

HRESULT GetIconLocation(
  [in]      LPCWSTR pszObjectClass,
  [in]      DWORD   dwFlags,
  [in, out] LPWSTR  pszBuffer,
  [in]      INT     cchBuffer,
  [in, out] INT     *presid
);

Параметры

[in] pszObjectClass

Указатель на строку Юникода с пустым завершением, содержащую имя класса объектов, для которого требуется получить расположение значка. Примеры имени класса объекта: user и container.

[in] dwFlags

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

DSGIF_ISNORMAL

Получает обычный значок для класса объекта.

DSGIF_ISOPEN

Получает значок открытия, например открытую папку, для класса объекта. Если у класса объекта нет открытого значка, этот метод пытается получить обычный значок для класса объекта.

DSGIF_ISDISABLED

Получает значок отключенного, например отключенного пользователя, для класса объекта . Если у класса объектов нет отключенного значка, этот метод пытается получить обычный значок для класса объекта.

DSGIF_GETDEFAULTICON

Если значок для класса объекта не найден, этот метод возвращает значок по умолчанию. Если этот флаг не указан и для класса объекта не найден значок, этот метод возвращает значение NULL.

DSGIF_DEFAULTISCONTAINER

Если значок для класса объекта не найден, этот метод возвращает значок контейнера в качестве значка по умолчанию. Если этот флаг не указан и для класса объекта не найден значок, этот метод возвращает значение NULL.

[in, out] pszBuffer

Указатель на широкий буфер символов, который получает путь и имя файла, содержащего значок. Длина этого буфера должна быть не менее символов cchBuffer .

[in] cchBuffer

Содержит размер буфера pszBuffer в широких символах, включая завершающий символ NULL . Если имя файла превышает это число символов, имя файла усекается.

[in, out] presid

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

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

Возвращает стандартное значение HRESULT , включая следующее.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	dsclient.h
DLL	Dsadmin.dll

См. также раздел

Интерфейсы отображения в доменные службы Active Directory

IDsDisplaySpecifier

IDsDisplaySpecifier::GetIcon

Поделиться через