RFC_OPTIONS (SAP ライブラリ

RFC_OPTIONS

以下の構造

typedef struct {
char * destination;
RFC_MODE mode;
void * connopt;
char * client;
char * user;
char * password;
char * language;
int trace;
} RFC_OPTIONS;

RfcOpen. のためのパラメタを提供します。

接続のタイプによっては、様々なデータを提供して RFC 接続を開く必要があります。

この情報を提供する方法は、以下の３つがあります。

1. ‘ saprfc.ini ’ファイルに、必要なすべての接続パラメータと RFC 独自のパラメータを含んだ宛先名を入力して、 RfcOpenで接続を開く方法。

2. ‘ sideinfo ’ファイルに、必要なすべての接続パラメータを含んだ宛先名を入力して、 RfcOpenで接続を開く方法。

3. 独自のプログラムにすべての必要なデータを提供して、 RfcOpenで接続を開く方法。

これらの方法のなかで最初（ saprfc.ini を使用）のものをおすすめします。なぜならば、この方法を使用すれば、現行の RFC 機能の一部は、将来も、 RFC プログラムを変更せずに使用できるからです。詳細は、 sprfc.ini を参照してください。

値を設定しない項目には、 NULL を設定する必要があります。

RFC_OPTIONS 構造は３つのグループから構成されます。

物理的な接続の確立に必要なデータは、接続のタイプ（ R/2 接続か R/3 接続、バージョンなど）にしたがいます。項目‘ mode ’の内容によって、項目‘ connopt ’が指す構造は異なります。

サインオンデータ（クライアント、ユーザ、パスワード、言語）は、認証で必要となります。 RfcOpenは、物理的接続を直接的にしか開かないので、こうしたデータは最初の RFC コールが送られた場合だけにチェックされます。

第３項目には、トレースフラグが含まれています。ゼロでない場合、エラー分析を容易にするために、この接続に対応するすべての操作についてトレースファイルが書かれます。

ノート

この構造全体を０で初期化する必要があります。それによって、将来の SAP が接続パラメータを追加できることを保証します。

この構造は SAPRFC.H 内に定義されます。

メンバ :

destination
宛先の名称
接続を完全に記述していない場合、この名称は‘ sideinfo ’のキーとして使用され、接続が記述されるようになります。この項目を常に埋める必要があります。

mode
接続モード
対象システムが R/2 システムか R/3 システムかにより、 RFC のプロトコルタイプは２つに分かれます。
対象システムがリリース 3.0C 以降の SAP である場合、ここに値 RFC_MODE_VERSION_3 を入力すれば、各種の特別なオプションを使用することができます。
項目‘ mode ’の内容によって、項目‘ connopt ’が指す構造は異なります。（ RFC_MODEを参照してください）。

connopt
connopt が NULL の場合、‘ sideinfo ’ファイルまたは‘ saprfc.ini ’ファイルを使用して接続パラメータが決まります。
‘ saprfc.ini ’ファイルがない場合には、 connopt は‘ mode ’値によってタイプ RFC_CONNOPT_R3ONLY, RFC_CONNOPT_VERSION_3または RFC_CONNOPT_CPIC構造を指す必要があります。 .

client
サインオンデータ : クライアント

user
サインオンデータ : ユーザ

password
サインオンデータ : パスワード

language
サインオンデータ : ログオン言語

trace
トレース
0 の場合、トレースは作成されません。０でない場合、 RFC ライブラリは、実際の作業ディレクトリにあるファイル‘ dev_rfc ’にすべての作業をトレースします。
対象システムがリリース 3.0C 以降の場合、値‘ D ’をここに入力することで、対象システム上で ABAP デバッガを起動することができます。
RfcReceive を再度コールするには、以下の汎用モジュールによってコール依頼を処理する必要があります。 RfcGetNameExt 、 RfcGetDataExt および RfcSendDataExt

R/3 接続用のオプション。

// static = initialized structures
static RFC_OPTIONS options;
static RFC_CONNOPT_R3ONLY rfc_connopt_r3only;
RFC_HANDLE handle
options.destination = ” TEST ” ;
options.mode = RFC_MODE_R3ONLY;
options.client = ” 000 ” ;
options.user = ” SAP* ” ;
options.language = ” E ” ;
options.password = ” PASS ” ;
options.trace = 0; // トレースオン

options.connopt = &rfc_connopt_r3only;
rfc_connopt_r3only.hostname = ” some_host ” ; // some host name
rfc_connopt_r3only.sysnr = 0; // system 00
handle = RfcOpen(&options);
if(handle == RFC_HANDLE_NULL)
{
...