I_NetLogonControl2函式 (lmaccess.h)

發行項
08/24/2023

I_NetLogonControl2函式會控制 Netlogon 服務的各個層面。

語法

NET_API_STATUS NET_API_FUNCTION I_NetLogonControl2(
  [in, optional] LPCWSTR ServerName,
  [in]           DWORD   FunctionCode,
  [in]           DWORD   QueryLevel,
  [in]           LPBYTE  Data,
  [out]          LPBYTE  *Buffer
);

參數

[in, optional] ServerName

遠端伺服器的名稱。

[in] FunctionCode

要執行的作業。此值可以是下列其中一項。

值	意義
NETLOGON_CONTROL_QUERY 1	無作業。只傳回要求的資訊。
NETLOGON_CONTROL_REPLICATE 2	強制備份網域控制站上的安全性帳戶管理員 (SAM) 資料庫， (BDC) 與主要網域控制站上的複本同步， (PDC) 。這項作業不表示完整同步處理。如果可能，Netlogon 服務會複寫任何未完成的差異。
NETLOGON_CONTROL_SYNCHRONIZE 3	強制 BDC 從 PDC 取得 SAM 資料庫的新複本。此作業會執行完整同步處理。
NETLOGON_CONTROL_PDC_REPLICATE 4	強制 PDC 要求每個 BDC 立即複寫。
NETLOGON_CONTROL_REDISCOVER 5	強制網域控制站 (DC) 重新探索指定的受信任網域 DC。
NETLOGON_CONTROL_TC_QUERY 6	查詢安全通道，要求其上次使用狀態更新。
NETLOGON_CONTROL_TC_VERIFY 10	驗證指定之受信任網域安全通道的目前狀態。如果狀態指出成功，則會 Ping 網域控制站。如果狀態或 Ping 指出失敗，則會重新探索新的受信任網域控制站。
NETLOGON_CONTROL_CHANGE_PASSWORD 9	強制對信任網域的安全通道進行密碼變更。
NETLOGON_CONTROL_FORCE_DNS_REG 11	強制網域控制站重新註冊其所有 DNS 記錄。 QueryLevel參數必須設定為 1。
NETLOGON_CONTROL_QUERY_DNS_REG 12	發出查詢，要求 Netlogon 服務所執行的 DNS 更新狀態。如果上次更新發生任何 DNS 註冊或取消註冊錯誤，則結果為負數。 QueryLevel參數必須設定為 1。

[in] QueryLevel

指出應該從 Netlogon 服務傳回哪些資訊。這個值可以是下列任何結構。

NETLOGON_INFO_1 (1)

NETLOGON_INFO_2 (2)

NETLOGON_INFO_3 (3)

NETLOGON_INFO_4 (4)

[in] Data

攜帶取決於 FunctionCode 參數中所指定值的輸入資料。 NETLOGON_CONTROL_REDISCOVER和NETLOGON_CONTROL_TC_QUERY函式代碼會指定 (資料類型為 LPWSTR *) 的受信任功能變數名稱。

[out] Buffer

傳回緩衝區的指標，其中包含 在 QueryLevel 參數中傳遞之結構中要求的資訊。

緩衝區必須使用 NetApiBufferFree釋放。

傳回值

方法會在成功時傳回 0x00000000 (NERR_Success) ;否則，它會傳回 Lmerr.h 或 Winerror.h 中定義的非零錯誤碼。 NET_API_STATUS錯誤碼開頭為值0x00000834。如需網路管理錯誤碼的詳細資訊，請參閱 Network_Management_Error_Codes。下表描述可能的傳回值。

傳回碼/值	描述
NERR_Success 0x00000000	方法呼叫已完成，而不會發生錯誤。
ERROR_ACCESS_DENIED 0x00000005	呼叫端的存取驗證會傳回 false。存取遭到拒絕。
ERROR_NOT_ENOUGH_MEMORY 0x00000008	沒有足夠的儲存體可用來處理此命令。
ERROR_NOT_SUPPORTED 0x00000032	函式程式碼在指定的伺服器上無效。例如，NETLOGON_CONTROL_REPLICATE可能已傳遞至 PDC) (主要網域控制站。
ERROR_INVALID_PARAMETER 0x00000057	參數不正確。
ERROR_INVALID_LEVEL 0x0000007C	查詢呼叫層級不正確。
ERROR_SERVICE_NOT_ACTIVE 0x000004261210121	尚未啟動服務。
ERROR_INVALID_COMPUTERNAME 0x000004BA	指定電腦名稱稱的格式無效。
ERROR_NO_LOGON_SERVERS 0x0000051F	目前沒有可供服務登入要求的登入伺服器。
ERROR_INVALID_DOMAIN_ROLE 0x0000054A	在 BDC () 備份網域控制站上嘗試變更網域間信任帳戶的密碼變更。此作業僅適用于網域的 PDC。
ERROR_NO_SUCH_DOMAIN 0x0000054B	指定的網域不存在或連不上。
NERR_UserNotFound 0x000008AD	找不到使用者名稱。