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