SLPOpen サブルーチン

オンライン編集

目的

SLP 要求の言語ロケールをカプセル化する SLPHandle ハンドルを戻します。

構文

SLPError SLPOpen(const char *pcLang, SLPBoolean isAsync, SLPHandle
   *phSLP);

説明

SLPOpen サブルーチンは、 pcLang パラメーターとして渡された言語ロケールの phSLP パラメーターに SLPHandle ハンドルを戻します。 クライアントは、 isAsync パラメーターによって、ハンドル上の操作が同期であるか非同期であるかを示します。 ハンドルは、ハンドルを介して発行される SLP 要求の言語ロケール、および実装に必要なその他のリソースをカプセル化します。 ただし、SLP プロパティーはハンドルによってカプセル化されません。これらはグローバルです。 この関数の戻り値は、操作の状況を示す SLPError コードです。 失敗すると、 phSLP パラメーターは NULL になります。

実行の特性

SLPHandle は、一度に 1 つの SLP API 操作にのみ使用できます。 元の操作が非同期に開始された場合、元の操作が保留中にハンドルで追加の操作を開始しようとすると、API 関数から SLP_HANDLE_IN_USE エラーが返されます。 SLPClose () API 関数は、ハンドル上の未解決の呼び出しを終了します。 実装が非同期 (応答) をサポートできない場合。 同期) 操作では、メモリー制約またはスレッド化サポートがないため、 isAsync フラグが SLP_TRUE (resp) の場合に SLP_NOT_IMPLEMENTED フラグが戻されることがあります。 SLP_FALSE)。

パラメーター

項目 説明
pcLang 文字の配列へのポインタAIX®では "en" のみサポート）。
isAsync SLPHandle を非同期操作用にオープンするかどうかを示す SLPBoolean 。 AIX は同期操作のみをサポートします。
phSLP SLPHandleへのポインター。ここには、オープンされている SLPHandle が戻されます。 エラーが発生した場合、戻り時の値は NULL です。

戻り値

SLPOpen が正常に実行されると、 SLP_OK と、 pcLang パラメーターとして渡された言語ロケールの phSLP パラメーター内の SLPHandle ハンドルを戻します。

エラー・コード

項目 説明
SLP エラー 操作の状況を示します