次の方法で共有


ldap_conn_from_msg関数 (winldap.h)

ldap_conn_from_msg 関数は、特定のメッセージの LDAP セッション ハンドル (接続ポインター) を返します。

構文

WINLDAPAPI LDAP *LDAPAPI ldap_conn_from_msg(
  [in] LDAP        *PrimaryConn,
  [in] LDAPMessage *res
);

パラメーター

[in] PrimaryConn

メッセージの LDAP セッション ハンドルへのポインター (既知の場合)。 メッセージの LDAP セッション ハンドルが不明な場合は、メッセージ セッションに対して LDAP_OPT_REF_DEREF_CONN_PER_MSG セッション オプションが以前に設定されている場合、このパラメーターに対して NULL を 渡すことができます。

[in] res

クエリされた LDAP メッセージ。 このパラメーター NULL が渡された場合、関数は NULL 戻り値で応答します。

戻り値

戻り値は、メッセージの送信元の LDAP セッション ハンドル (接続ポインター) です。 この関数は NULL を返します。元のセッションが閉じている場合、または NULLLDAPMessage ポインターが関数に渡され、メッセージ セッションに対して LDAP_OPT_REF_DEREF_CONN_PER_MSG セッション オプションが以前に設定されていない場合です。

備考

この関数は、指定された LDAP メッセージに関連付けられている LDAP セッション ハンドルを識別するために使用されます。 次のいずれかの条件が満たされた場合にのみ、有効な LDAP セッション ハンドルが返されます。

  • LDAPMessage は、PrimaryConn パラメーターで関数に渡されたのと同じ LDAP セッション ハンドルから生成されます。
  • LDAP_OPT_REF_DEREF_CONN_PER_MSG セッション オプションは、メッセージに関連付けられている LDAP セッションで以前に有効にされていました。
これらの両方の条件が満たされていない場合、この関数は NULL セッション ハンドルを返します。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista
サポートされる最小サーバー Windows Server 2008
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winldap.h
ライブラリ Wldap32.lib
DLL Wldap32.dll

関連項目

LDAP セッション の確立

Functions

LDAP

LDAPMessage

戻り値

ldap_init

ldap_set_option

構造体