情報カタログ・マネージャー プログラミングの手引きおよび解説書

FLGManageIcons

代表的な OS/2 または Windows のアイコンを 作成、削除、入手、照会、または更新します。

許可

管理者; ユーザー (FLG_ACTION_GET および FLG_ACTION_QUERY のみ)

構文



APIRET  APIENTRY   FLGManageIcons( PSZ          pszObjTypeID,
                                 PSZ              pszIconFileID,
                                   FLGOPTIONS   InOptions,
                                    PFLGOPTIONS      pOutOptions,
                                  PFLGEXTCODE  pExtCode );

パラメーター

pszObjTypeID (PSZ) − 入力
アイコンを検索、照会、作成、更新、または削除したいオブジェクト・タイプ の 6 文字のシステム生成された固有の識別子 (オブジェクト・タイプ ID) を指します。

pszIconFileID (PSZ) − 入力
指定されたオブジェクト・タイプの、検索、作成、または更新したい OS/2 ま たは Windows のアイコンを含むファイルのドライブ、ディレクトリー・パス、および ファイル名 (FAT または HPFS ファイルに有効) を含みます。 このパラメーターは、FLG_ACTION_QUERY および FLG_ACTION_DELETE では、無視され ます。

InOptions (FLGOPTIONS) − 入力
望まれるアクションおよびプラットフォーム・オプションを示します。 以下のいずれかのアクション・オプションを選択します。

FLG_ACTION_CREATE
指定されたアイコンを指定されたオブジェクト・タイプに追加します。
FLG_ACTION_DELETE
指定されたアイコンを指定されたオブジェクト・タイプから取り外します。
FLG_ACTION_GET
指定されたアイコン・ファイルを検索します。
FLG_ACTION_QUERY
指定されたアイコン・ファイルが存在するかどうかを判別します。
FLG_ACTION_UPDATE
アイコンを指定されたオブジェクト・タイプに変更します。

以下のいずれかのプラットフォーム・オプションを選択します。

FLG_PLATFORM_OS2
OS/2 アイコンを管理します。
FLG_PLATFORM_WINDOWS
Windows アイコンを管理します。

pOutOptions (PFLGOPTIONS) − 出力
FLG_ACTION_QUERY によって戻される、以下のいずれかの状況を指します。

FLG_ICON_EXIST
FLG_ICON_NOTEXIST

pExtCode (PFLGEXTCODE) − 出力
理由コードに関連する拡張コードを指します。 戻された理由コードに関連した意味のある拡張コードがあるかどうかについて は、付録 D, 情報カタログ・マネージャーの理由コードを参照してください。

理由コード (APIRET)
この API 呼び出しの実行結果を表します。

戻された理由コードの説明については、付録 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);


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]