GetColorDirectoryW 関数 (icm.h)
注意
この API は、今後のリリースでは使用できない可能性があります。 新規および既存のソフトウェアでは、カラー プロファイルの操作に他の API を使用することをお勧めします。 いくつかの例については、次の表を参照してください。
シナリオ | メカニズム |
---|---|
インストールされているすべてのプロファイルの列挙 | WcsEnumColorProfilesSize と WcsEnumColorProfiles または EnumColorProfilesW を使用する |
カラー プロファイルのインストール/アンインストール | InstallColorProfileWUninstallColorProfileW/ を使用する |
カラー プロファイル ファイルを直接開く | PROFILE 構造体パラメーターで dwType=PROFILE_FILENAME で OpenColorProfileW を使用します。 または 、WcsOpenColorProfileW を使用します。 Icm.h には、カラー プロファイル操作のために返された HPROFILE を受け入れる多くの API が含まれています |
指定したコンピューター上の Windows COLOR ディレクトリのパスを取得します。
構文
BOOL GetColorDirectoryW(
PCWSTR pMachineName,
PWSTR pBuffer,
PDWORD pdwSize
);
パラメーター
pMachineName
予約; は NULL である必要があります。 このパラメーターは、プロファイルをインストールするコンピューターの名前を指すことを目的としています。 NULL ポインターは、ローカル コンピューターを示します。
pBuffer
カラー ディレクトリ パスを配置するバッファーを指します。
pdwSize
pBuffer が指すバッファーのサイズ (バイト単位) を含む変数を指します。 戻り値の場合、変数には実際に使用または必要なバッファーのサイズが含まれます。
戻り値
この関数が成功した場合、戻り値は TRUE になります。
この関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。
注釈
ユーザーごと/LUA のサポート
カラー ディレクトリは引き続きシステム全体です。 この関数は、LUA コンテキストで実行可能です。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
Header | icm.h |
Library | Mscms.lib |
[DLL] | Mscms.dll |