dsGetIcon 函数 (dsclient.h)

DsGetIcon 函数获取给定对象类的图标。此函数已过时。新应用程序应使用 IDsDisplaySpecifier：：GetIcon 方法执行此函数。

语法

HICON DsGetIcon(
  [in] DWORD   dwFlags,
  [in] LPCWSTR pszObjectClass,
  [in] INT     cxImage,
  [in] INT     cyImage
);

[in] dwFlags

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

获取对象类的普通图标。

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

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

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

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

[in] pszObjectClass

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

[in] cxImage

包含图标的所需宽度（以像素为单位）。此函数检索与此宽度最匹配的图标。

[in] cyImage

包含图标的所需高度（以像素为单位）。此函数检索与此高度最匹配的图标。

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