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 |