ldap_set_option関数 (winldap.h)
ldap_set_option関数は、接続ブロックのオプションを設定します。 構造体の詳細については、「 データ構造」を参照してください。
構文
WINLDAPAPI ULONG LDAPAPI ldap_set_option(
[in] LDAP *ld,
[in] int option,
[in] const void *invalue
);
パラメーター
[in] ld
セッション ハンドル。
[in] option
オプション セットの名前。
[in] invalue
オプションが指定される値へのポインター。 このパラメーターの実際の型は、オプション パラメーターの設定によって異なります。 オンまたはオフの設定を持つオプションには、定数LDAP_OPT_ONとLDAP_OPT_OFFを指定できます。
戻り値
関数が成功した場合、戻り値は LDAP_SUCCESS。
関数が失敗した場合はエラー コードを返します。 詳細については、「 戻り値」を参照してください。
注釈
ldap_set_optionを呼び出して、LDAP セッションを表す LDAP 構造にアクセスします。 LDAP データ構造を直接変更しないでください。
LDAP セッションに適用されるオプション設定の詳細と説明については、「 セッション オプション」を参照してください。 フラグの詳細については、「 DsGetDcName」を参照してください。
Kerberos 認証プロトコルを使用して、Windows LDAP サーバーとの間のすべての LDAP トラフィックにデジタル署名または暗号化できるようになりました。 この新機能により、一部のアプリケーションで必要な整合性と機密性が提供されます。 Secure Sockets Layer (SSL) を使用すると同じ利点がありますが、サーバーと場合によってはクライアントに対して広範な証明書登録が必要になることに注意してください。
署名とシールを有効にするには、bind メソッドの LDAP_AUTH_NEGOTIATE を使用して ldap_bind_s を呼び出す前に、次のいずれかのオプションを有効にする必要があります。
#define LDAP_OPT_SIGN 0x95
#define LDAP_OPT_ENCRYPT 0x96
署名とシールをオフにするには、接続ハンドルで ldap_unbind() を呼び出して接続を閉じます。
マルチスレッド: ldap_set_option の呼び出しは、接続全体に影響するため、安全ではありません。 スレッドが接続を共有する場合は注意が必要です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | winldap.h |
| Library | Wldap32.lib |
| [DLL] | Wldap32.dll |