ページの先頭行へ戻る
Interstage List Works V11.0.0 APIリファレンス
FUJITSU Software

1.4.8 LW_GetKeepListItem(保管フォルダ内の帳票一覧取得)

記述形式

int  LW_GetKeepListItem(LWAPIHANDLE    iServerApiHandle,
                        LWLISTHANDLE   iStartKeepListHandle,
                        int            iKeepListIndex,
                        LPKPLINFO      lpKPLInfo)

機能

帳票の一覧情報を取得します。


パラメタの説明

iServerApiHandle

サーバAPI識別子を指定します。

iStartKeepListHandle

帳票一覧識別子を指定します。

iKeepListIndex

取得したい帳票が格納されているインデックスを0から「帳票数 - 1」までの数値で指定します。

範囲外の値を指定した場合、エラーになります。

lpKPLInfo

帳票一覧を取得するためのKPLINFO構造体 (帳票情報構造体)のアドレスを指定します。

KPLINFO構造体の領域は、呼び出し元で獲得してください。

KPLINFO構造体の「usl_Length」は、必ず指定してください。KPLINFO構造体の「usl_Length」を指定しないと、エラーになります。

KPLINFO構造体を、以下に示します。

typedef struct KeepListInfo
{
unsigned short  usl_Length;              /*領域長                      */
char            cl_Rsv1[2];              /*リザーブ                    */
unsigned short  usl_Rsv2;                /*リザーブ                    */
char            cl_Rsv3[2];              /*リザーブ                    */
char            cl_Title[64 + 4];        /*帳票名                      */
char            cl_SubTitle[64 + 4];     /*コメント                    */
char            cl_Comment1[64 + 4];     /*備考1                       */
char            cl_Comment2[64 + 4];     /*備考2                       */
char            cl_Comment3[64 + 4];     /*備考3                       */
char            cl_Comment4[64 + 4];     /*備考4                       */
char            cl_SplFile[260 + 4];     /*帳票の論理パス名            */
char            cl_OwnerName[64 + 4];    /*作成者名                    */
char            cl_AddDate[16 + 4];      /*登録日時                    */
char            cl_CreateDate[16 + 4];   /*作成日時                    */
char            cl_LastAcsDate[16 + 4];  /*最終参照日時                */
char            cl_TermDate[10 + 2];     /*登録有効期限                */
char            cl_LocalSave;            /*リザーブ                    */
char            cl_IndexSearch;          /*抜き出し検索ファイルの有無  */
char            cl_DelType;              /*削除対象                    */
char            cl_PrtType;              /*リモート印刷依頼            */
char            cl_MemType;              /*帳票記入情報の有無          */
char            cl_F66Type;              /*リザーブ                    */
char            cl_Polling;              /*ポーリング印刷依頼          */
char            cl_Rsv4[1];              /*リザーブ                    */
unsigned short  usl_AccessNum;           /*アクセス回数                */
char            cl_Rsv5[2];              /*リザーブ                    */
unsigned long   ull_AllPageNum;          /*全ページ数                  */
char            cl_SplId[16 + 4];        /*リザーブ                    */
char            cl_PaperOrient;          /*印刷用紙の向き              */
char            cl_PaperSize;            /*印刷用紙サイズ              */
char            cl_Rsv6[2];              /*リザーブ                    */
unsigned short  usl_PrintWidth;          /*印刷横倍率                  */
char            cl_Rsv7[2];              /*リザーブ                    */
unsigned short  usl_PrintHeight;         /*印刷縦倍率                  */
char            cl_Rsv8[2];              /*リザーブ                    */
char            cl_Rsv9[156];            /*リザーブ                    */
} KPLINFO; 
typedef  KPLINFO*   LPKPLINFO; 

KPLINFO構造体の説明

メンバ変数

項目

説明

usl_Length

領域長

構造体のサイズを指定します。

本APIを実行する前に、呼び出し元でsizeof(KPLINFO)を実行してください。

cl_Rsv1

リザーブ

usl_Rsv2

リザーブ

cl_Rsv3

リザーブ

cl_Title

帳票名

帳票名が設定されます。

cl_SubTitle

コメント

コメントが設定されます。

cl_Comment1

備考1

備考1が設定されます。

cl_Comment2

備考2

備考2が設定されます。

cl_Comment3

備考3

備考3が設定されます。

cl_Comment4

備考4

備考4が設定されます。

cl_SplFile

帳票の論理パス名

帳票の論理パス名が設定されます。

cl_OwnerName

作成者名

作成者名が設定されます。

cl_AddDate

登録日時

登録日時が設定されます。

cl_CreateDate

作成日時

作成日時が設定されます。

cl_LastAcsDate

最終参照日時

最終参照日時が設定されます。

cl_TermDate

登録有効期限

登録有効期限が設定されます。

cl_LocalSave

リザーブ

cl_IndexSearch

抜き出し検索ファイルの有無

抜き出し検索ファイルの有無が設定されます。

0:無
1:有

cl_DelType

削除対象

削除対象が設定されます。

0:有効期限を過ぎても削除対象としない
1:有効期限を過ぎたら削除対象とする

cl_PrtType

リモート印刷依頼

リモート印刷依頼が設定されます。

0:印刷未
1:印刷済

cl_MemType

帳票記入情報の有無

帳票記入情報の有無が設定されます。

0:無
1:有

cl_F66Type

リザーブ

cl_Polling

ポーリング印刷依頼

ポーリング印刷依頼が設定されます。

0:印刷未
1:印刷済

cl_Rsv4

リザーブ

usl_AccessNum

アクセス回数

アクセス回数が設定されます。

cl_Rsv5

リザーブ

ull_AllPageNum

全ページ数

全ページ数が設定されます。

cl_SplId

リザーブ

cl_PaperOrient

印刷用紙の向き

印刷する時の印刷用紙の向きが設定されます。

0:指定なし
1:ポートレート
2:ランドスケープ

cl_PaperSize

印刷用紙サイズ

印刷用紙サイズが設定されます。

0:指定なし
1:Letter 8 1/2 × 11 インチ
5:Legal 8 1/2 × 14 インチ
8:A3 297 × 420 mm
9:A4 210 × 297 mm
11:A5 148 × 210 mm
12:B4 (JIS) 250 × 354
13:B5 (JIS) 182 × 257 mm
43:Japanese Postcard 100 × 148 mm
66:A2 420 × 594 mm
70:A6 105 × 148 mm

cl_Rsv6

リザーブ

usl_PrintWidth

印刷横倍率

印刷横倍率(%)が設定されます。

cl_Rsv7

リザーブ

usl_PrintHeight

印刷縦倍率

印刷縦倍率(%)が設定されます。

cl_Rsv8

リザーブ

cl_Rsv9

リザーブ


復帰値

0

正常終了しました。

-1

異常終了しました。


注意

指定した保管フォルダの全帳票一覧情報を取得したい場合、インデックスを0から「帳票数 - 1」までインクリメントして、本APIを帳票数分実行してください。


参考

異常終了した場合に以下のサーバ機能APIを実行すると、エラーの詳細を取得することができます。

エラーコードの取得

LW_GetServerApiErrCode(サーバ機能APIエラーコード取得)

LW_GetServerApiErrCodeについては、“1.3.1 LW_GetServerApiErrCode(サーバ機能APIエラーコード取得)”を参照してください。
エラーメッセージの取得

LW_GetServerApiErrMsg(サーバ機能APIエラーメッセージ取得)

LW_GetServerApiErrMsgについては、“1.3.2 LW_GetServerApiErrMsg(サーバ機能APIエラーメッセージ取得)”を参照してください。