IDsDisplaySpecifier：：GetIcon 方法 (dsclient.h)

IDsDisplaySpecifier：：GetIcon 方法获取给定对象类的图标。

语法

HICON GetIcon(
  [in] LPCWSTR pszObjectClass,
  [in] DWORD   dwFlags,
  [in] INT     cxIcon,
  [in] INT     cyIcon
);

[in] pszObjectClass

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要获取其图标的对象类的名称。对象类名的示例包括“user”和“container”。

[in] dwFlags

包含一组指示要检索的图标类型的标志。这可以是以下一个或多个值的组合。

获取对象类的普通图标。

获取对象类的打开图标，例如打开的文件夹。如果对象类没有打开的图标，此方法将尝试获取对象类的普通图标。

获取对象类的禁用图标，例如禁用的用户。如果对象类没有禁用的图标，此方法将尝试获取对象类的普通图标。

用于屏蔽 DSGIF_ISNORMAL、 DSGIF_ISOPEN 和 DSGIF_ISDISABLED 标志。

如果找不到对象类的图标，此方法将返回默认图标。如果未指定此标志，并且找不到对象类的图标，则此方法返回 NULL。

如果找不到对象类的图标，此方法将返回容器图标作为默认图标。如果未指定此标志，并且找不到对象类的图标，则此方法返回 NULL。

[in] cxIcon

包含图标的所需宽度（以像素为单位）。此方法获取与此宽度最接近的图标。

[in] cyIcon

包含图标的所需高度（以像素为单位）。此方法获取与此高度最接近的图标。

如果成功，则返回图标的句柄，否则返回 NULL 。当不再需要此图标时，调用方必须销毁此图标，方法是将此句柄传递给 DestroyIcon。