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 流量。 這項新功能提供某些應用程式所需的完整性和機密性。 請注意,使用安全套接字層 (SSL) 可提供您相同的優點,但需要伺服器的廣泛憑證註冊,有時也會要求客戶端的憑證註冊。
若要啟用簽署和封存,您必須先開啟下列其中一個選項,才能使用系結方法的 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 |
程式庫 | Wldap32.lib |
Dll | Wldap32.dll |