LDAPControlA 結構 (winldap.h)
LDAPControl 結構代表用戶端和伺服器控制項。
語法
typedef struct ldapcontrolA {
PCHAR ldctl_oid;
struct berval ldctl_value;
BOOLEAN ldctl_iscritical;
} LDAPControlA, *PLDAPControlA;
成員
ldctl_oid
表示控件類型的寬 null 終止字串指標，例如 “1.2.840.113556.1.4.805”。
ldctl_value
如果有的話，與控件相關聯的數據。 如果沒有數據與控件相關聯，請將這個成員設定為 NULL。
ldctl_iscritical
指出控制項是否為重要，稱為 [關鍵性] 欄位。
備註
透過LDAP 3生效，您可以透過使用控件來擴充LDAP作業。 伺服器控制項可以傳送至伺服器，或使用任何LDAP訊息傳回至用戶端。 用戶端控制檔只會延伸用戶端上LDAP API的行為，且永遠不會傳送至伺服器。 支援的控件會儲存為目錄服務根目錄中的 OID) 物件 (識別碼。
當伺服器或用戶端不支援 控件時， ldctl_iscritical 成員可讓擴充作業成功。 如果這個欄位的值是零，則伺服器和/或用戶端如果不支援並執行作業，則會忽略控件。 如果值為非零值，則只有在伺服器和/或客戶端辨識控件時，才會執行作業。
如需詳細資訊，以及支援的LDAP擴充控件及其描述的清單，請參閱 擴充控件。
注意
winldap.h 標頭會將LDAPControl定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 標頭 | winldap.h |