NetGroupSetUsers 函式 (lmaccess.h)

發行項
02/28/2024

NetGroupSetUsers 函式會設定指定之全域群組的成員資格。您指定的每個用戶都會註冊為全域群組的成員。您未指定但目前是全域群組成員的使用者，將會撤銷其成員資格。

語法

NET_API_STATUS NET_API_FUNCTION NetGroupSetUsers(
  [in] LPCWSTR servername,
  [in] LPCWSTR groupname,
  [in] DWORD   level,
  [in] LPBYTE  buf,
  [in] DWORD   totalentries
);

參數

[in] servername

常數位符串的指標，指定要執行函式之遠端伺服器的 DNS 或 NetBIOS 名稱。如果此參數為 NULL，則會使用本機電腦。

[in] groupname

常數位符串的指標，指定感興趣的全域組名。如需詳細資訊，請參閱＜備註＞一節。

[in] level

數據的資訊層級。此參數可以是下列其中一個值。

值	意義
0	buf 參數指向指定用戶名稱之GROUP_USERS_INFO_0結構的陣列。
1	buf 參數指向指定用戶名稱和群組屬性之GROUP_USERS_INFO_1結構的陣列。

[in] buf

包含數據的緩衝區指標。如需詳細資訊，請參閱網路管理功能緩衝區。

[in] totalentries

buf 參數所指向之緩衝區中的項目數目。

傳回值

如果函式成功，傳回值會NERR_Success。

如果函式失敗，傳回值可以是下列其中一個錯誤碼。

傳回碼	Description
ERROR_ACCESS_DENIED	用戶無法存取要求的資訊。
ERROR_INVALID_LEVEL	系統呼叫層級不正確。如果層級參數指定為 0 或 1 以外的值，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	傳遞的參數無效。如果 totalentries 參數無效，就會傳回此錯誤。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足，無法完成作業。
NERR_InvalidComputer	電腦名稱無效。
NERR_NotPrimary	只有在網域的主要域控制器上才允許此作業。
NERR_GroupNotFound	找不到全域組名。
NERR_InternalError	發生內部錯誤。
NERR_SpeGroupOp	某些特殊群組不允許此作業。這些群組包括使用者群組、系統管理員群組、本地組和來賓群組。
NERR_UserNotFound	找不到用戶名稱。

備註

如果您在執行 Active Directory 的域控制器上呼叫此函式，則會根據安全性實體對象的訪問控制清單 (ACL) ，允許或拒絕存取。預設 ACL 只允許網域管理員和帳戶操作員呼叫此函式。在成員伺服器或工作站上，只有系統管理員和 Power Users 可以呼叫此函式。如需詳細資訊，請參閱網路管理功能的安全性需求。如需 ACL、ACE 和存取令牌的詳細資訊，請參閱存取控制模型。

Group 物件的安全性描述元是用來執行此函式的存取檢查。

您可以藉由呼叫 NetGroupSetUsers 函式，以全新的成員清單取代全域群組成員資格。執行此動作的一般步驟順序如下。

取代全域群組成員資格

呼叫 NetGroupGetUsers 函式以擷取目前的成員資格清單。
修改傳回的成員資格清單，以反映新的成員資格。
呼叫 NetGroupSetUsers 函式，以新的成員資格清單取代舊的成員資格清單。

若要授與現有全域群組中的一個用戶成員資格，您可以呼叫 NetGroupAddUser 函式。若要從全域群組中移除使用者，請呼叫 NetGroupDelUser 函式。

用戶帳戶名稱限製為 20 個字元，且組名限製為 256 個字元。此外，帳戶名稱不能以句號終止，而且不能包含逗號或任何下列可列印字元：“、/、、、[、]、：、|<>、?、*。名稱也無法在範圍 1-31 中包含不可列印的字元。

如果您是針對 Active Directory 進行程式設計，您可以呼叫特定 Active Directory 服務介面 (ADSI) 方法來達成相同的功能，方法是呼叫網路管理功能。如需詳細資訊，請參閱 IADsGroup。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	lmaccess.h (包括 Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll