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

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

オブジェクトクラスの標準アイコンを取得します。

オブジェクトクラスの開いているアイコン (開いているフォルダーなど) を取得します。オブジェクトクラスに開いているアイコンがない場合、このメソッドはオブジェクトクラスの通常のアイコンを取得しようとします。

オブジェクトクラスの無効なユーザーなどの無効なアイコンを取得します。オブジェクトクラスに無効なアイコンがない場合、このメソッドはオブジェクトクラスの通常のアイコンを取得しようとします。

DSGIF_ISNORMAL、DSGIF_ISOPEN、およびDSGIF_ISDISABLEDフラグをマスクするために使用されます。

オブジェクトクラスのアイコンが見つからない場合、このメソッドは既定のアイコンを返します。このフラグが指定されておらず、オブジェクトクラスのアイコンが見つからない場合、このメソッドは NULL を返します。

オブジェクトクラスのアイコンが見つからない場合、このメソッドはコンテナーアイコンを既定のアイコンとして返します。このフラグが指定されておらず、オブジェクトクラスのアイコンが見つからない場合、このメソッドは NULL を返します。

[in] cxIcon

アイコンの目的の幅 (ピクセル単位) を含みます。このメソッドは、この幅に最も近いアイコンを取得します。

[in] cyIcon

アイコンの目的の高さをピクセル単位で格納します。このメソッドは、この高さに最も近いアイコンを取得します。

成功した場合はアイコンへのハンドルを返し、それ以外の場合は NULL を 返します。呼び出し元は、このハンドルを DestroyIcon に渡すことで不要になったときに、このアイコンを破棄する必要があります。