共用方式為


NetLocalGroupGetInfo 函式 (lmaccess.h)

NetLocalGroupGetInfo函式會擷取伺服器上特定本機群群組帳戶的相關資訊。

語法

NET_API_STATUS NET_API_FUNCTION NetLocalGroupGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR groupname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

參數

[in] servername

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

[in] groupname

常數位符串的指標,指定將擷取資訊的本機群組帳戶名稱。 如需詳細資訊,請參閱接下來的<備註>一節。

[in] level

指定資料的資訊層級。 此參數可以是下列值。

意義
1
傳回與本機群組相關聯的批註。 bufptr參數指向LOCALGROUP_INFO_1結構。

[out] bufptr

接收傳回信息結構的緩衝區位址指標。 此緩衝區是由系統所配置,而且必須使用 NetApiBufferFree 函式釋放。 如需詳細資訊,請參閱 網路管理功能緩衝區網路管理功能緩衝區長度

傳回值

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

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

傳回碼 描述
ERROR_ACCESS_DENIED
使用者無法存取要求的資訊。
NERR_InvalidComputer
電腦名稱無效。
NERR_GroupNotFound
指定的本機群組不存在。

備註

如果您在執行 Active Directory 的網域控制站上呼叫此函式,則會根據 安全性實體物件的存取控制清單 (ACL) ,允許或拒絕存取。 預設 ACL 允許所有已驗證的使用者和「Windows 2000 相容存取」群組的成員檢視資訊。 如果您在成員伺服器或工作站上呼叫此函式,所有已驗證的使用者都可以檢視資訊。 如需有關匿名存取和限制這些平臺上匿名存取的資訊,請參閱 網路管理功能的安全性需求。 如需 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

另請參閱

LOCALGROUP_INFO_1

本機群組函式

NetLocalGroupEnum

NetLocalGroupGetMembers

NetLocalGroupSetInfo

NetQueryDisplayInformation

網路管理功能

網路管理概觀