ldap_get_option函式 (winldap.h)

ldap_get_option函式會擷取整個會話參數的目前值。

語法

WINLDAPAPI ULONG LDAPAPI ldap_get_option(
  [in]  LDAP *ld,
  [in]  int  option,
  [out] void *outvalue
);

[in] ld

會話控制碼。

[in] option

存取的選項名稱。如需詳細資訊和允許的選項及其值清單，請參閱下列一節。

[out] outvalue

選項值的位址。此參數的實際類型取決於選項參數的設定。

如果函式成功，傳回值 會LDAP_SUCCESS。

如果函式失敗，它會傳回錯誤碼。如需詳細資訊，請參閱傳回值。

如需適用于 LDAP 會話之選擇性設定的詳細資訊和描述，請參閱會話選項。 outvalue值會傳回會話選項資料表中所列類型所配置記憶體區塊的指標;除非會話選項資料表中明確提及此記憶體，否則當不再需要資料時，應該使用ldap_memfree釋放此記憶體。

注意LDAP_OPT_ERROR_STRING 傳回內部靜態字串資料表的指標，在使用這個會話選項時不應該呼叫 ldap_memfree 。

多執行緒： ldap_get_option 函式是安全線程。