共用方式為


IDsDisplaySpecifier::GetIconLocation 方法 (dsclient.h)

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