定義
function awPDF_CombineAddFileW(
const | SessionID : Integer, |
const | FileName : PWideChar |
) : Integer;
機能
対象ファイルを結合対象ファイル一覧へ追加します。
引数
SessionID | 関数 awPDF_ConnectServer で取得したセッションIDを設定します。 |
FileName | 変換を行う対象ファイル名をフルパスで設定します。(※1) |
!!注意!! ※1
awPDFはUnicodeに対応していません。Unicode版の関数はデフォルト文字列型がUnicodeである開発環境での本ライブラリの使用を簡便にするために用意されたものですが、引数の文字列にANSI文字に変換できないUnicode特有の文字が含まれている場合正しく動作しません。
解説
ファイル結合で対象となるファイルをセッションオブジェクトの結合対象ファイル一覧に追加します。
結合対象ファイル一覧は、関数 awPDF_CombineClearFiles を呼び出すか、変換サーバとの接続の切断、セッションオブジェクトが破棄されるまで保持されます。
!!注意!!
複数の対象ファイルをまとめて指定することはできません。対象ファイルの数だけ、関数 awPDF_CombineAddFile を呼び出しファイルの追加を行ってください。
!!注意!!
変換サーバで設定されている最大ファイルサイズを超えるファイルの追加はできません。ファイルサイズが最大ファイルサイズを超える場合関数 awPDF_CombineAddFile はエラーコード値を返します。変換サーバの最大ファイルサイズは、関数 awPDF_GetMaxFileSize で取得することができます。
戻り値
成功した場合は0 を、エラーが発生した場合はエラーコード値を返します。