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