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

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要获取其图标位置的对象类的名称。对象类名称的示例包括“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
标头	dsclient.h
DLL	Dsadmin.dll

另请参阅

在 Active Directory 域服务中显示接口

IDsDisplaySpecifier

IDsDisplaySpecifier：：GetIcon

通过