5.2.9 非同期処理の中止

Interstage Application Server Smart Repository運用ガイド

目次索引

5.2.9 非同期処理の中止

関数名	関数の説明
ldap_abandon()	非同期処理を破棄(中断)します。
ldap_abandon_ext()	非同期処理を破棄(中断)します。（LDAP V3拡張関数）

ldap_abandon

　この関数は、非同期型のLDAP操作を途中で中止します。処理を中止したリクエストに対するresult情報は、ライブラリ内部で破棄されるため、呼出し元には通知されません。

　ldapssl_init()で獲得したセションハンドルを使用している場合、SSLライブラリで発生したエラーをldapssl_error()で参照することができます。

【指定形式】

#include "idldap.h"
int  ldap_abandon(
        LDAP  *ld,
        int  msgid );

【パラメタの説明】

ld
　ldap_init()、またはldapssl_init()で通知された、セションハンドルを指定します。
msgid
　中止したい非同期処理のメッセージIDを指定します。

【復帰値】

　この関数では、復帰値として以下の値を返します。

正常完了の場合： 0
異常完了の場合： -1
　異常完了の場合、以下の原因が考えられます。
- パラメタの指定に誤りがあります。
- 使用可能なメモリが不足しました。

ldap_abandon_ext

　ldapssl_init()で獲得したセションハンドルを使用している場合、SSLライブラリで発生したエラーをldapssl_error()で参照することができます。

【指定形式】

#include "idldap.h"
int  ldap_abandon_ext(
        LDAP  *ld,
        int  msgid,
        LDAPControl  **serverctrls,
        LDAPControl  **clientctrls );

【パラメタの説明】

ld
　ldap_init()、またはldapssl_init()で通知された、セションハンドルを指定します。
msgid
　中止したい非同期処理のメッセージIDを指定します。
serverctrls
　Smart Repositoryではサーバコントロールをサポートしていないため、このパラメタにはNULLを指定します。
clientctrls
　本ライブラリではクライアントコントロールをサポートしていないため、このパラメタにはNULLを指定します。

【復帰値】

　この関数では、復帰値としてLDAPエラーコードを返します。LDAPエラーコードの値については、“LDAPエラーコード”を参照してください。

正常完了の場合： LDAP_SUCCESS
異常完了の場合： LDAP_SUCCESS以外のLDAPエラーコード

目次索引