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 |
---|---|
|
用戶無法存取要求的資訊。 |
|
電腦名稱無效。 |
|
只有在網域的主要域控制器上才允許此作業。 |
|
groupname 參數指定的本地組不存在。 |
|
指定的本地組不存在。 |
備註
如果您在執行 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 |