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，以終結此圖示。