共用方式為


NetLocalGroupDel 函式 (lmaccess.h)

NetLocalGroupDel 函式會從安全性資料庫刪除本機群組帳戶及其所有成員,也就是安全性帳戶管理員 (SAM) 資料庫,或者,如果是域控制器,則為 Active Directory。

語法

NET_API_STATUS NET_API_FUNCTION NetLocalGroupDel(
  [in] LPCWSTR servername,
  [in] LPCWSTR groupname
);

參數

[in] servername

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

[in] groupname

常數位符串的指標,指定要刪除的本地組帳戶名稱。 如需詳細資訊,請參閱接下來的<備註>一節。

傳回值

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

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

傳回碼 Description
ERROR_ACCESS_DENIED
用戶無法存取要求的資訊。
NERR_InvalidComputer
電腦名稱無效。
NERR_NotPrimary
只有在網域的主要域控制器上才允許此作業。
NERR_GroupNotFound
groupname 參數指定的本地組不存在。
ERROR_NO_SUCH_ALIAS
指定的本地組不存在。

備註

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

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

用戶帳戶名稱限製為 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

另請參閱

本地組函式

NetLocalGroupAdd

NetLocalGroupDelMembers

網路管理功能

網路管理概觀