代表的な OS/2 または Windows のアイコンを 作成、削除、入手、照会、または更新します。
許可
管理者; ユーザー (FLG_ACTION_GET および FLG_ACTION_QUERY のみ)
構文
APIRET APIENTRY FLGManageIcons( PSZ pszObjTypeID,
PSZ pszIconFileID,
FLGOPTIONS InOptions,
PFLGOPTIONS pOutOptions,
PFLGEXTCODE pExtCode );
パラメーター
以下のいずれかのプラットフォーム・オプションを選択します。
戻された理由コードの説明については、付録 D, 情報カタログ・マネージャーの理由コードを参照してくだ さい。
使用方法
前提条件
FLGManageIcons を呼び出すまえに、FLGCreateReg を呼び出して、 アイコンを管理したいオブジェクト・タイプを登録する必要があります。
情報カタログ更新の制御
プログラムを可能な限り、情報カタログと同期化させるために、 FLGManageIcons が正常にアイコンを作成、更新、または削除したあとで、 呼び出しを FLGCommit (FLGCommit参照) に組み込む必要があります。 FLGManageIcons が、正常にアイコンを作成、更新、または削除しない場合は、 呼び出しを FLGRollback に組み込む必要があります (FLGRollback参照)。
図 123 は、FLGManageIcons 呼び出しを出すために必要な C 言語コード を示しています。 このサンプル・コードは、情報カタログ・マネージャーにおける Windows アイコンを更新します。
図 123. C 言語による FLGManageIcons の呼び出しのサンプル
APIRET rc; // reason code from FLGManageIcons
UCHAR pszObjTypeID[FLG_OBJTYPID_LEN + 1];
UCHAR pszIconFileID[FLG_ICON_FILE_ID_MAXLEN + 1];
FLGOPTIONS Options = 0; // initialize option
FLGEXTCODE xc=0; // extended code
.
. /* provide values for input parameters */
.
Options = Options | FLG_ACTION_UPDATE | FLG_PLATFORM_WINDOWS;
rc = FLGManageIcons (pszObjTypeID,
pszIconFileID,
Options,
NULL,
&xc);