dsBindA 函式 (ntdsapi.h)

DsBind 函式會系結至域控制器。DsBind 會使用預設進程認證來系結至域控制器。若要指定替代認證，請使用 DsBindWithCred 函式。

語法

NTDSAPI DWORD DsBindA(
  [in, optional] LPCSTR DomainControllerName,
  [in, optional] LPCSTR DnsDomainName,
  [out]          HANDLE *phDS
);

[in, optional] DomainControllerName

Null 終止字串的指標，其中包含要系結的域控制器名稱。此名稱可以是域控制器的名稱或域控制器的完整 DNS 名稱。任一名稱類型都可以選擇性地加上兩個反斜杠字元。下列所有範例都代表格式正確的域控制器名稱：

此參數可以是 Null。如需詳細資訊，請參閱＜備註＞。

[in, optional] DnsDomainName

Null 終止字串的指標，其中包含要系結之網域的完整 DNS 名稱。此參數可以是 Null。如需詳細資訊，請參閱＜備註＞。

[out] phDS

接收系結句柄之 HANDLE 值的位址。若要關閉此句柄，請將它傳遞給 DsUnBind 函式。

如果成功或 Windows 或 RPC 錯誤碼，則傳回 ERROR_SUCCESS 否則傳回。以下是最常見的錯誤碼。

DsBind 函式的行為取決於 DomainControllerName 和 DnsDomainName 參數的內容。下列清單會根據這些參數的內容描述此函式的行為。

DomainControllerName	DnsDomainName	Description
NULL	NULL	DsBind 會嘗試系結至本機計算機樹系中的全域編錄伺服器。
(value)	NULL	DsBind 會嘗試系結至 DomainControllerName 參數所指定的域控制器。
NULL	(value)	DsBind 會嘗試系結至 DnsDomainName 參數所指定網域中的任何域控制器。
(值 )	(value)	DomainControllerName 參數優先。 DsBind 會嘗試系結至 DomainControllerName 參數所指定的域控制器。

注意

ntdsapi.h 標頭會將 DsBind 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。