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

另請參閱

數據結構

LDAPMessage

使用控件