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
取得するアイコンの種類を示すフラグのセットが含まれます。 これは、次の 1 つ以上の組み合わせにすることができます。
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 |