DsGetDcOpenA 函式 （dsgetdc.h）
DsGetDcOpen 函式會開啟新的域控制器列舉作業。
語法
DSGETDCAPI DWORD DsGetDcOpenA(
[in] LPCSTR DnsName,
[in] ULONG OptionFlags,
[in, optional] LPCSTR SiteName,
[in, optional] GUID *DomainGuid,
[in, optional] LPCSTR DnsForestName,
[in] ULONG DcFlags,
[out] PHANDLE RetGetDcContext
);
參數
[in] DnsName
Null 終止字串的指標，其中包含要列舉域控制器之網域命名系統 （DNS） 名稱的字串。 這個參數不能 NULL。
[in] OptionFlags
包含一組旗標，可修改函式的行為。 這可以是零或下列一或多個值的組合。
DS_ONLY_DO_SITE_NAME
只會列舉月臺特定的域控制器。
DS_NOTIFY_AFTER_SITE_RECORDS
在擷取所有月臺特定域控制器之後，DsGetDcNext 函式會傳回 ERROR_FILEMARK_DETECTED 值。 DsGetDcNext 接著會列舉第二個群組，其中包含網域中的所有域控制器，包括第一個群組中包含的月臺特定域控制器。
[in, optional] SiteName
包含用戶端所使用之網站名稱之 Null 終止字串的指標。 這個參數是選擇性的，而且可能會 NULL。
[in, optional] DomainGuid
GUID 值的指標，其中包含由 DnsName所指定的網域識別符。 此標識碼是用來處理重新命名網域的案例。 如果指定這個值，並且重新命名 DnsName 中指定的網域，此函式會嘗試列舉包含指定識別符的網域中的域控制器。 這個參數是選擇性的，而且可能會 NULL。
[in, optional] DnsForestName
Null 終止字串的指標，其中包含包含 DnsName 網域之樹系的名稱。 如果網域已重新命名，這個值會與 DomainGuid 搭配使用，以列舉域控制器。 這個參數是選擇性的，而且可能會 NULL。
[in] DcFlags
包含一組旗標，可識別要列舉的域控制器類型。 這可以是零或下列一或多個值的組合。
DS_FORCE_REDISCOVERY
強制忽略快取的域控制器數據。 未指定此旗標時，DsGetDcOpen 從快取的域控制器數據取得域控制器列舉。
DS_GC_SERVER_REQUIRED
要求列舉的域控制器必須是具有此網域之網域樹系的全域編錄伺服器，做為根目錄。 這個旗標無法與 DS_PDC_REQUIRED 旗標結合。
DS_KDC_REQUIRED
要求列舉的域控制器目前正在執行 Kerberos 金鑰發佈中心服務。 這個旗標無法與 DS_PDC_REQUIRED 或 DS_GC_SERVER_REQUIRED 旗標結合。
DS_ONLY_LDAP_NEEDED
指定列舉的伺服器是LDAP伺服器。 伺服器不一定是域控制器。 每個列舉伺服器不會隱含其他服務。 伺服器不一定具有可寫入的 組態 容器，也不一定具有可寫入 架構 容器。 伺服器不一定用來建立或修改安全性原則。 此旗標可與 DS_GC_SERVER_REQUIRED 旗標搭配使用，以列舉同時裝載全域編錄伺服器的LDAP伺服器。 在此情況下，列舉的全域編錄伺服器不一定是域控制器，而其他服務則隱含在每個伺服器上。 如果指定此旗標，則會忽略 DS_PDC_REQUIRED、DS_TIMESERV_REQUIRED、DS_GOOD_TIMESERV_PREFERRED、DS_DIRECTORY_SERVICES_PREFERED、DS_DIRECTORY_SERVICES_REQUIRED和 DS_KDC_REQUIRED 旗標。
DS_PDC_REQUIRED
要求列舉域控制器是網域的主要域控制器。 這個旗標無法與 DS_GC_SERVER_REQUIRED 旗標合併。
[out] RetGetDcContext
接收域控制器列舉內容句柄之 HANDLE 值的指標。 此句柄會與 DsGetDcNext 函式搭配使用，以識別域控制器列舉作業。 此句柄會傳遞至 DsGetDcClose 關閉域控制器列舉作業。
傳回值
如果成功或 Win32 或 RPC 錯誤，則傳回 ERROR_SUCCESS 否則傳回 。 可能的錯誤值包括下列專案。
言論
注意
dsgetdc.h 標頭會將 DsGetDcOpen 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 支援的最低伺服器 | Windows Server 2008 |
| 目標平臺 | 窗戶 |
| 標頭 | dsgetdc.h |
| 連結庫 | Netapi32.lib |
| DLL | Netapi32.dll |