DsGetIcon 関数 (dsclient.h)

DsGetIcon 関数は、特定のオブジェクトクラスのアイコンを取得します。この関数は、現在使用されていません。新しいアプリケーションでは、 IDsDisplaySpecifier::GetIcon メソッドを使用してこの関数を実行する必要があります。

構文

HICON DsGetIcon(
  [in] DWORD   dwFlags,
  [in] LPCWSTR pszObjectClass,
  [in] INT     cxImage,
  [in] INT     cyImage
);

[in] dwFlags

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

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

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

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

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

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

[in] pszObjectClass

アイコンを取得するオブジェクトクラスの名前を含む null で終わる Unicode 文字列へのポインター。オブジェクトクラス名の例として、"user" と "container" があります。

[in] cxImage

アイコンの目的の幅をピクセル単位で格納します。この関数は、この幅に最も近いアイコンを取得します。

[in] cyImage

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

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