网络管理类集合

• 下载源代码 - 7 Kb

• 概述
•    CNetDomain 类
•       CNetDomain
•       SetDomainName
•       GetDomainName
•       GetPDC
•       m_strError
•    CNetUsers 类
•       CNetUsers
•       Add
•       删除
•       SetUser
•       GetUser
•       SetPassword
•       ChangePassword
•       ForceChangePassword
•       IsForcedChangePassword
•       DisableUser
•       GetUserInfo
•       SetFullName
•       GetFullName
•       SetComment
•       GetComment
•       SetHomeDirectory
•       GetHomeDirectory
•       SetHomeDirDrive
•       GetHomeDirDrive
•       SetUserPrivilege
•       GetUserPrivilege
•       SetOperatorPrivilege
•       GetOperatorPrivilege
•       SetNotChangePass
•       GetNoChangePass
•       SetWorkStations
•       GetWorkStations
•       GetBadPasswordCount
•       GetLogonCount
•       GetPasswordAge
•       IsUserDisable
•       QueryFirstUser
•       QueryNextUser
•       FindFirstUser
•       FindNextUser
•       m_strError
•    CNetGroups 类
•       CNetGroups
•       GetGroup
•       Add
•       AddUser
•       DeleteUser
•       删除
•       FindFirstGroup
•       FindNextGroup
•       FindFirstUser
•       FindNextUser
•       SetGroup
•       GetGroup
•       m_strError
•    CNetLocalGroups 类
•       CNetLocalGroups
•       GetGroup
•       Add
•       AddUser
•       DeleteUser
•       删除
•       FindFirstGroup
•       FindNextGroup
•       FindFirstUser
•       FindNextUser
•       SetGroup
•       GetGroup
•       m_strError
• 要求

概述

我创建这些类是为了使网络管理变得容易。为此，我创建了 CNetDomain 类、CNetUsers 类、CNetGroups 类和 CNetLocalGroups 类。

CNetDomain 类

CNetDomain::CNetDomain

构造一个 CNetDomain 对象。

CNetDomain();
CNetDomain(CString strDomainName);

参数

CString strDomainName 包含域名字符串。如果此参数为空，则使用机器登录的域。

备注

如果使用第一个构造函数，CNetDomain 类将仅使用正在运行的机器，获取并更新其上的信息。

例如

CNetDomain pDomain(_T(""));            //This sample use the domain where 
is logued the Machine...
CNetDomain pDomain(_T("Developers"));  //This sample use the Developers 
domain...
CNetDomain pDomain();                  //This sample use the local 
machine...

CNetDomain::SetDomainName

SetDomainName 在 CNetDomain 对象中设置域名。

void SetDomainName(CString strDomainName);

参数

CString strDomainName 包含域名的字符串。

CNetDomain::GetDomainName

GetDomainName 函数返回 CNetDomain 对象中的域名。

CString GetDomainName();

CNetDomain::GetPDC

GetPDC 函数返回主域控制器 (PDC) 的名称。

DWORD GetPDC(CString& strPDC);

参数

CString& strPDC 缓冲区接收域主域控制器 (PDC) 的服务器名称。

返回值

如果成功，则返回 0。

CNetDomain::m_strError

备注

m_strError 数据成员包含最后一个错误字符串。

CNetUsers 类

CNetUsers::CNetUsers

CNetUsers。

CNetUsers();
CNetUsers(CNetDomain pDomain);

参数

CNetDomain pDomain

CNetUsers::Add

Add 函数添加用户。

DWORD Add(CString strUser, CString strPassword);

参数

CString strUser 包含要添加的用户名的字符串。

CString strPassword 包含用户密码的字符串。

返回值

如果成功，函数返回 0。

参见示例

CNetDomain pDomain(_T(""));

CNetUsers pUsers(pDomain);

if(pUsers.Add("TestUser", "Newpass") == 0)
{
	pUsers.DisableUser(FALSE);

	BOOL bRet;

	pUsers.IsUserDisable(bRet);

	if(bRet)
		AfxMessageBox("The user is Disable");
	else
		AfxMessageBox("The user is Enable");
}

CNetUsers::Delete

Delete 函数删除用户。

DWORD Delete(CString strUserName);

参数

CString strUserName 指定用户账户名称的字符串。

返回值

如果成功，函数返回 0。

CNetUsers::SetUser

SetUser 函数在 CNetUsers 对象中设置用户。

void SetUser(CString strUserName);

参数

CString strUserName 指定用户账户名称的字符串。

CNetUsers::GetUser

GetUser 函数返回 CNetUsers 对象中的用户名。

CString GetUser();

返回值

函数返回带有用户名的字符串。

CNetUsers::SetPassword

SetPassword 函数设置用户密码。

DWORD SetPassword(CString strUserName, CString strPassword);
DWORD SetPassword(CString strPassword);

参数

CString strUserName 指定用户账户名称的字符串。

CString strPassword 包含用户密码的字符串。

返回值

如果成功，函数返回 0。

CNetUsers::ChangePassword

ChangePassword 函数更改用户密码。

DWORD ChangePassword(CString strUserName, CString strOldPassword, CString 
strNewPassword);
DWORD ChangePassword(CString strOldPassword, CString strNewPassword);

参数

CString strUserName 指定用户账户名称的字符串。

CString strOldPassword 包含旧用户密码的字符串。

CString strNewPassword 包含新用户密码的字符串。

返回值

如果成功，函数返回 0。

CNetUsers::ForceChangePassword

ForceChangePassword 函数强制用户在下次登录时更改密码。

DWORD ForceChangePassword(CString strUserName, BOOL bChangePass = TRUE);
DWORD ForceChangePassword(BOOL bChangePass = TRUE);

参数

CString strUserName 指定用户账户名称的字符串。

BOOL bChangePass 设置更改密码的指针。

返回值

如果成功，函数返回 0。

CNetUsers::IsForcedChangePassword

IsForcedChangePassword 函数返回用户是否必须在下次登录时更改密码。

DWORD IsForcedChangePassword(CString strUserName, BOOL& bChangePass);
DWORD IsForcedChangePassword(BOOL& bChangePass);

参数

CString strUserName 指定用户账户名称的字符串。

BOOL& bChangePass 对返回用户是否必须更改密码的变量的引用。

返回值

如果成功，函数返回 0。

CNetUsers::DisableUser

DisableUser 函数禁用用户。

DWORD DisableUser(CString strUserName, BOOL bDisable = TRUE);
DWORD DisableUser(BOOL bDisable = TRUE);

参数

CString strUserName 指定用户账户名称的字符串。

BOOL bDisable 禁用用户的指针。

返回值

如果成功，函数返回 0。

参见示例

CNetUsers::GetUserInfo

GetUserInfo 函数获取有关用户的信息。

DWORD GetUserInfo(CString strUserName, CNetUserInfo* pUserInfo);
DWORD GetUserInfo(CNetUserInfo* pUserInfo);

参数

CString strUserName 指定用户账户名称的字符串。

CNetUserInfo* pUserInfo 指向 CNetUserInfo 对象的指针。

struct CNetUserInfo
{
	LPSTR	name;
	LPSTR	password;
	DWORD	password_age;
	DWORD	priv;
	LPSTR	home_dir;
	LPSTR	comment;
	DWORD	flags;
	LPSTR	script_path;
	DWORD	auth_flags;
	LPSTR	full_name;
	LPSTR	usr_comment;
	LPSTR	parms;
	LPSTR	workstations;
	DWORD	last_logon;
	DWORD	last_logoff;
	DWORD	acct_expires;
	DWORD	max_storage;
	DWORD	units_per_week;
	PBYTE	logon_hours;
	DWORD	bad_pw_count;
	DWORD	num_logons;
	LPSTR	logon_server;
	DWORD	country_code;
	DWORD	code_page;
	DWORD	user_id;
	DWORD	primary_group_id;
	LPSTR	profile;
	LPSTR	home_dir_drive;
	BOOL	password_expired;
};

例如

CNetUserInfo pUserInfo;
pUsers.GetUserInfo("Administrator", &pUserInfo);

返回值

如果成功，函数返回 0。

CNetUsers::SetFullName

SetFullName 函数设置用户的全名。

DWORD SetFullName(CString strUserName, CString strFullName);
DWORD SetFullName(CString strFullName);

参数

CString strUserName 指定用户账户名称的字符串。

CString strFullName 包含用户全名的字符串。

返回值

如果成功，函数返回 0。

CNetUsers::GetFullName

GetFullName 函数获取用户的全名。

DWORD GetFullName(CString strUserName, CString& strFullName);
DWORD GetFullName(CString& strFullName);

参数

CString strUserName 指定用户账户名称的字符串。

CString& strFullName 对返回用户全名的字符串的引用。

返回值

如果成功，函数返回 0。

CNetUsers::SetComment

SetComment 函数设置用户注释。

DWORD SetComment(CString strUserName, CString strComment);
DWORD SetComment(CString strComment);

参数

CString strUserName 指定用户账户名称的字符串。

CString strComment 包含用户注释的字符串。

返回值

如果成功，函数返回 0。

CNetUsers::GetComment

GetComment 函数获取用户注释。

DWORD GetComment(CString strUserName, CString& strComment);
DWORD GetComment(CString& strComment);

参数

CString strUserName 指定用户账户名称的字符串。

CString strComment 对返回用户注释的字符串的引用。

返回值

如果成功，函数返回 0。

CNetUsers::SetHomeDirectory

SetHomeDirectory 函数设置用户主目录。

DWORD SetHomeDirectory(CString strUserName, CString strHomeDirectory);
DWORD SetHomeDirectory(CString strHomeDirectory);

参数

CString strUserName 指定用户账户名称的字符串。

CString strHomeDirectory 包含用户主目录的字符串。

返回值

如果成功，函数返回 0。

CNetUsers::GetHomeDirectory

GetHomeDirectory 函数获取用户主目录。

DWORD GetHomeDirectory(CString strUserName, CString& strHomeDirectory);
DWORD GetHomeDirectory(CString& strHomeDirectory);

参数

CString strUserName 指定用户账户名称的字符串。

CString& strHomeDirectory 对返回用户主目录的字符串的引用。

返回值

如果成功，函数返回 0。

CNetUsers::SetHomeDirDrive

SetHomeDirDrive 函数设置分配给用户主目录的驱动器号，用于登录目的。

DWORD SetHomeDirDrive(CString strUserName, CString strHomeDirDrive);
DWORD SetHomeDirDrive(CString strHomeDirDrive);

参数

CString strUserName 指定用户账户名称的字符串。

CString strHomeDirDrive 包含驱动器号的字符串。

返回值

如果成功，函数返回 0。

CNetUsers::GetHomeDirDrive

GetHomeDirDrive 函数获取分配给用户主目录的驱动器号，用于登录目的。

DWORD GetHomeDirDrive(CString strUserName, CString& strHomeDirectory);
DWORD GetHomeDirDrive(CString& strHomeDirectory);

参数

CString strUserName 指定用户账户名称的字符串。

CString& strHomeDirDrive 包含驱动器号的字符串。

返回值

如果成功，函数返回 0。

CNetUsers::SetUserPrivilege

SetUserPrivilege 函数设置用户权限。

DWORD SetUserPrivilege(CString strUserName, int nPrivilege);
DWORD SetUserPrivilege(int nPrivilege);

参数

CString strUserName 指定用户账户名称的字符串。

int nPrivilege 可以是以下值之一

    CNetUsers::usrPrivGuest   访客
    CNetUsers::usrPrivUser     用户
    CNetUsers::usrPrivAdmin   管理员

返回值

如果成功，函数返回 0。

CNetUsers::GetUserPrivilege

GetUserPrivilege 函数获取用户权限。

DWORD GetUserPrivilege(CString strUserName, int& nPrivilege);
DWORD GetUserPrivilege(int& nPrivilege);

参数

CString strUserName 指定用户账户名称的字符串。

int& nPrivilege 返回用户权限的数字引用。请参阅 SetUserPrivilege

返回值

如果成功，函数返回 0。

CNetUsers::SetOperatorPrivilege

SetOperatorPrivilege 函数指定分配给用户网络账户的操作员权限。

DWORD SetOperatorPrivilege(CString strUserName, int nPrivileges);
DWORD SetOperatorPrivilege(int nPrivileges);

参数

CString strUserName 指定用户账户名称的字符串。

int nPrivileges 定义分配给用户网络账户的操作员权限的位标志集。

    CNetUers::opPrivPrint        打印操作员权限已启用。
    CNetUers::opPrivComm     通信操作员权限已启用。
    CNetUers::opPrivServer     服务器操作员权限已启用。
    CNetUers::opPrivAccounts  账户操作员权限已启用。

CNetUsers::GetOperatorPrivilege

GetOperatorPrivilege 函数检索分配给用户网络账户的操作员权限。

DWORD GetOperatorPrivilege(CString strUserName, int& nPrivileges);
DWORD GetOperatorPrivilege(int& nPrivileges);

参数

CString strUserName 指定用户账户名称的字符串。

int& nPrivileges 对返回定义分配给用户网络账户的操作员权限的位标志集的数字引用。

返回值

如果成功，函数返回 0。

CNetUsers::SetNotChangePass

SetNotChangePass 函数设置用户是否可以更改密码。

DWORD SetNotChangePass(CString strUserName, BOOL bPermit = FALSE);
DWORD SetNotChangePass(BOOL bPermit = FALSE);

参数

CString strUserName 指定用户账户名称的字符串。

BOOL bPermit 确定用户是否可以更改密码的布尔值。

返回值

如果成功，函数返回 0。

CNetUsers::GetNotChangePass

GetNotChangePass 函数获取用户是否可以更改密码。

DWORD GetNotChangePass(CString strUserName, BOOL& bNotPermit);
DWORD GetNotChangePass(BOOL& bNotPermit);

参数

CString strUserName 指定用户账户名称的字符串。

BOOL& bNotPermit 确定用户是否可以更改密码的布尔引用。

返回值

如果成功，函数返回 0。

CNetUsers::SetWorkStations

SetWorkStations 函数指定用户可以登录的工作站名称。

DWORD SetWorkStations(CString strUserName, CString strWorkStations);
DWORD SetWorkStations(CString strWorkStations);

参数

CString strUserName 指定用户账户名称的字符串。

CString strWorkStations 包含用户可以登录的工作站名称的字符串。

最多可以指定八个工作站；名称必须用逗号分隔。空字符串表示没有限制。

例如

	pUsers.SetWorkStations("pc1,pc2,pc3");
	pUsers.SetWorkStations("");

返回值

如果成功，函数返回 0。

CNetUsers::GetWorkStations

GetWorkStations 函数获取用户可以登录的工作站名称。

DWORD GetWorkStations(CString strUserName, CString& strWorkStations);
DWORD GetWorkStations(CString& strWorkStations);

参数

CString strUserName 指定用户账户名称的字符串。

CString& strWorkStations 对包含用户可以登录的工作站名称的字符串的引用。

返回值

如果成功，函数返回 0。

CNetUsers::GetBadPasswordCount

GetBadPasswordCount 函数返回用户尝试使用不正确密码登录此账户的次数。

DWORD GetBadPasswordCount(CString strUserName, long& nCount);
DWORD GetBadPasswordCount(long& nCount);

参数

CString strUserName 指定用户账户名称的字符串。

long& nCount 对指示用户尝试登录次数的长整型值的引用。

返回值

如果成功，函数返回 0。

CNetUsers::GetLogonCount

GetLogonCount 函数返回用户成功登录此账户的次数。

DWORD GetLogonCount(CString strUserName, long& nCount);
DWORD GetLogonCount(long& nCount);

参数

CString strUserName 指定用户账户名称的字符串。

long& nCount 对指示用户成功登录次数的长整型值的引用。

返回值

如果成功，函数返回 0。

CNetUsers::GetPasswordAge

GetPasswordAge 函数返回自用户上次更改密码以来经过的秒数。

DWORD GetPasswordAge(CString strUserName, DWORD& nSeconds);
DWORD GetPasswordAge(DWORD& nSeconds);

参数

CString strUserName 指定用户账户名称的字符串。

DWORD& nSeconds 对指示已过去秒数的 DWORD 值的引用。

返回值

如果成功，函数返回 0。

CNetUsers::IsUserDisable

IsUserDisable 函数返回用户账户是否已禁用。

DWORD IsUserDisable(CString strUserName, BOOL& bDisable);
DWORD IsUserDisable(BOOL& bDisable);

参数

CString strUserName 指定用户账户名称的字符串。

BOOL& bDisable 对指示用户账户是否已禁用的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

参见示例

CNetUsers::QueryFirstUser

QueryFirstUser 函数返回用户账户信息。

DWORD QueryFirstUser(CString& strUserName, BOOL& bMoreData);

参数

CString& strUserName 对返回用户账户名称的字符串的引用。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

CNetUsers::QueryNextUser

QueryNextUser 函数返回用户账户信息。

DWORD QueryNextUser(CString& strUserName, BOOL& bMoreData);

参数

CString& strUserName 对返回用户账户名称的字符串的引用。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

CNetUsers::FindFirstUser

FindFirstUser 函数提供有关服务器上所有用户账户的信息。

DWORD FindFirstUser(CString& strUserName, BOOL& bMoreData);
DWORD FindFirstUser(BOOL& bMoreData);

参数

CString& strUserName 对返回用户账户名称的字符串的引用。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

参见示例

CNetUsers::FindNextUser

FindNextUser 函数提供有关服务器上所有用户账户的信息。

DWORD FindNextUser(CString& strUserName, BOOL& bMoreData);
DWORD FindNextUser(BOOL& bMoreData);

参数

CString& strUserName 对返回用户账户名称的字符串的引用。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

参见示例

CNetDomain pDomain(_T(""));

CNetUsers pUsers(pDomain);
CNetGroups pGroups(pDomain);

CString str;
BOOL bMore;

pUsers.FindFirstUser(str, bMore);
while(bMore)
{
	.
	.
	pUsers.FindNextUser(str, bMore);
}

pGroups.FindFirstGroup(str, bMore);
while(bMore)
{
	.
	.
	pGroups.FindNextGroup(str, bMore);
}

CNetUsers::m_strError

备注

m_strError 数据成员包含最后一个错误字符串。

CNetGroups 类

CNetGroups::CNetGroups

CNetGroups。

CNetGroups(CNetDomain pDomain);
CNetGroups();

参数

CNetDomain pDomain

CNetGroups::GetGroup

GetGroup 函数返回 CNetGroups 对象中的全局组名称。

CString GetGroup();

返回值

函数返回带有全局组名称的字符串。

CNetGroups::Add

Add 函数在安全数据库中创建一个全局组。

DWORD Add(CString strGroupName, CString strComments = _T(""));

参数

CString strGroupName 指定要添加的全局组名称的字符串。

CString strComments 指定与全局组关联的注释字符串。

返回值

如果成功，函数返回 0。

CNetGroups::AddUser

AddUser 函数将一个现有用户账户添加到现有全局组中。

DWORD AddUser(CString strGroupName, CString strUserName);
DWORD AddUser(CString strUserName);

参数

CString strGroupName 指定全局组名称的字符串。

CString strUserName 指定要添加到全局组成员中的用户名称的字符串。

返回值

如果成功，函数返回 0。

CNetGroups::DeleteUser

DeleteUser 函数从安全数据库中的特定全局组中删除用户。

DWORD DeleteUser(CString strGroupName, CString strUserName);
DWORD DeleteUser(CString strUserName);

参数

CString strGroupName 指定全局组名称的字符串。

CString strUserName 指定要从全局组中删除的用户名称的字符串。

返回值

如果成功，函数返回 0。

CNetGroups::Delete

Delete 函数从安全数据库中删除一个全局组。

DWORD Delete();
DWORD Delete(CString strGroupName);

参数

CString strGroupName 指定要删除的全局组名称的字符串。

返回值

如果成功，函数返回 0。

CNetGroups::FindFirstGroup

FindFirstGroup 函数检索安全数据库中每个全局组的信息。

DWORD FindFirstGroup(CString& strGroupName, BOOL& bMoreData);
DWORD FindFirstGroup(BOOL& bMoreData);

参数

CString& strGroupName 对指定已找到的全局组名称的字符串的引用。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

参见示例

CNetGroups::FindNextGroup

FindNextGroup 函数检索安全数据库中每个全局组的信息。

DWORD FindNextGroup(CString& strGroupName, BOOL& bMoreData);
DWORD FindNextGroup(BOOL& bMoreData);

参数

CString& strGroupName 对指定已找到的全局组名称的字符串的引用。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

CNetGroups::FindFirstUser

FindFirstUser 函数检索全局组账户中每个用户的信息。

DWORD FindFirstUser(CString strGroupName, CString& strUserName, BOOL& 
bMoreData);
DWORD FindFirstUser(CString& strUserName, BOOL& bMoreData);

参数

CString strGroupName 指定要在其中查找的全局组名称的字符串。

CString& strUserName 对返回用户名的字符串的引用。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

CNetGroups::FindNextUser

FindNextUser 函数检索全局组账户中每个用户的信息。

DWORD FindNextUser(CString& strUserName, BOOL& bMoreData);

参数

CString& strUserName 对返回用户名的字符串的引用。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

CNetGroups::SetGroup

SetGroup 设置当前全局组账户。

void SetGroup(CString strGroupName);

参数

CString strGroupName 指定全局组账户名称的字符串。

CNetGroups::GetGroup

GetGroup 返回当前全局组账户的名称。

CString GetGroup();

返回值

函数返回全局组账户名称。

CNetGroups::m_strError

备注

m_strError 数据成员包含最后一个错误字符串。

CNetLocalGroups 类

CNetLocalGroups::CNetLocalGroups

CNetLocalGroups。

CNetLocalGroups(CNetDomain pDomain);
CNetLocalGroups();

参数

CNetDomain pDomain

CNetLocalGroups::GetGroup

GetGroup 函数返回 CNetLocalGroups 对象中的本地组名称。

CString GetGroup();

返回值

函数返回带有本地组名称的字符串。

CNetLocalGroups::Add

Add 函数在安全数据库中创建一个本地组。

DWORD Add(CString strLocalGroupName, CString strComments = _T(""));

参数

CString strLocalGroupName 指定要添加的本地组名称的字符串。

CString strComments 指定与本地组关联的注释字符串。

返回值

如果成功，函数返回 0。

CNetLocalGroups::AddUser

AddUser 函数将一个现有用户账户添加到现有本地组中。

DWORD AddUser(CString strLocalGroupName, CString strUserName);
DWORD AddUser(CString strUserName);

参数

CString strLocalGroupName 指定要添加的本地组名称的字符串。

CString strUserName 指定要添加到本地组成员中的用户名称的字符串。

返回值

如果成功，函数返回 0。

CNetLocalGroups::DeleteUser

DeleteUser 函数从本地组中删除用户。

DWORD DeleteUser(CString strLocalGroupName, CString strUserName);
DWORD DeleteUser(CString strUserName);

参数

CString strLocalGroupName 指定本地组名称的字符串。

CString strUserName 指定要从本地组中删除的用户名称的字符串。

返回值

如果成功，函数返回 0。

CNetLocalGroups::Delete

Delete 函数从安全数据库中删除一个本地组。

DWORD Delete();
DWORD Delete(CString strLocalGroupName);

参数

CString strLocalGroupName 指定要删除的本地组名称的字符串。

返回值

如果成功，函数返回 0。

CNetLocalGroups::FindFirstGroup

FindFirstGroup 函数检索安全数据库中每个本地组的信息。

DWORD FindFirstGroup(CString& strLocalGroupName, BOOL& bMoreData);
DWORD FindFirstGroup(BOOL& bMoreData);

参数

CString strLocalGroupName 指定已找到的本地组名称的字符串。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

CNetLocalGroups::FindNextGroup

FindNextGroup 函数检索安全数据库中每个本地组的信息。

DWORD FindNextGroup(CString& strLocalGroupName, BOOL& bMoreData);
DWORD FindNextGroup(BOOL& bMoreData);

参数

CString strLocalGroupName 指定已找到的本地组名称的字符串。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

CNetLocalGroups::FindFirstUser

FindFirstUser 函数检索本地组账户中每个用户的信息。

DWORD FindFirstUser(CString strLocalGroupName, CString& strUserName, BOOL& 
bMoreData);
DWORD FindFirstUser(CString& strUserName, BOOL& bMoreData);

参数

CString strLocalGroupName 指定本地组名称的字符串，前缀为域名和“\”分隔符。例如：DEVELOPER\Administrator

CString& strUserName 对返回用户名的字符串的引用。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

CNetLocalGroups::FindNextUser

FindNextUser 函数检索本地组账户中每个用户的信息。

DWORD FindNextUser(CString& strUserName, BOOL& bMoreData);

参数

CString& strUserName 对返回用户名的字符串的引用，前缀为域名和“\”分隔符。

BOOL& bMoreData 对指示是否有更多数据要获取的 BOOL 值的引用。

返回值

如果成功，函数返回 0。

CNetLocalGroups::SetGroup

SetGroup 设置一个本地组账户。

void SetGroup(CString strLocalGroupName);

参数

CString strLocalGroupName 指定本地组名称的字符串。

CNetLocalGroups::GetGroup

GetGroup 返回当前本地组账户的名称。

CString GetGroup();

返回值

函数返回本地组账户名称。

CNetLocalGroups::m_strError

备注

m_strError 数据成员包含最后一个错误字符串。

要求

  Windows NT/2000: 需要 Windows NT 3.1 或更高版本。
  Windows 95/98: 不支持。
  库: 使用 Netapi32.lib。

Carlos A. Antollini。

更新

2001年11月28日    1.0 版发布。

2001年12月03日    1.08 版

• 添加了以下函数

CNetGroups::FindFirstUser, CNetGroups::FindNextUser, CNetLocalGroups::FindFirstUser, CNetLocalGroups::FindNextUser

2002年01月16日    1.10 版

• 添加了以下函数

CNetUsers::GetHomeDirDrive, CNetUsers::SetHomeDirDrive

特别感谢

这些网络类收到了用户的大量建议。
感谢所有人的协作和想法。

Ingo Stapel
Spiros Prantalos