Набор классов для системного администратора.Компилятор: Visual C++ Автор: Carlos Antollini
ВведениеЗдесь представлены четыре класса Класс CNetDomainCNetDomain::CNetDomainКонструктор объекта CNetDomain. CNetDomain(); CNetDomain(CString strDomainName); Параметры
For Example: CNetDomain pDomain(_T("")); //Используется текущий домен
CNetDomain pDomain(_T("Developers")); //Используется домен Developers
CNetDomain pDomain(); //Используется локальный компьютер
CNetDomain::SetDomainNameSetDomainName устанавливает имя домена в объекте CNetDomain. void SetDomainName(CString strDomainName);
Параметры
CNetDomain::GetDomainNameФункция GetDomainName возвращает имя домена, используемого объектом CNetDomain. CString GetDomainName();
CNetDomain::GetPDCФункция GetPDC возвращает имя первичного контроллера домена (Primary Domain Controller (PDC)). DWORD GetPDC(CString& strPDC); Параметры
Возвращаемые значения В случае успеха, возвращается
CNetDomain::m_strErrorОписание: Переменная-член m_strError, содержащая строку с последней ошибкой.
Класс CNetUsers
CNetUsers::CNetUsers
Конструктор CNetUsers . CNetUsers(); CNetUsers(CNetDomain pDomain); Параметры
CNetUsers::Add
Функция Add добавляет пользователя. DWORD Add(CString strUser, CString strPassword); Параметры
Возвращаемые значения
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); Параметры
Возвращаемое значение
CNetUsers::SetUser
Функция SetUser устанавливаем пользователя в объекте CNetUsers. void SetUser(CString strUserName);
Параметры
CNetUsers::GetUser
Функция GetUser возвращает имя пользователя, установленного в объекте CNetUsers. CString GetUser(); Возвращаемое значение Функция возвращает строку с именем пользователя.
CNetUsers::SetPassword
Функция SetPassword устанавливает пароль пользователя. DWORD SetPassword(CString strUserName, CString strPassword); DWORD SetPassword(CString strPassword); Параметры
Возвращаемое значение
CNetUsers::ChangePassword
Функция ChangePassword изменяет пароль пользователя DWORD ChangePassword(CString strUserName, CString strOldPassword, CString strNewPassword); DWORD ChangePassword(CString strOldPassword, CString strNewPassword); Параметры
Возвращаемое значение
CNetUsers::ForceChangePassword
Функция ForceChangePassword заставляет пользователя сменить пароль при следующем входе в систему. DWORD ForceChangePassword(CString strUserName, BOOL bChangePass = TRUE); DWORD ForceChangePassword(BOOL bChangePass = TRUE); Параметры
Возвращаемое значение
CNetUsers::IsForcedChangePassword
Функция IsForcedChangePassword позволяет узнать, должен ли пользователь сменить пароль при следующем входе в систему. DWORD IsForcedChangePassword(CString strUserName, BOOL& bChangePass); DWORD IsForcedChangePassword(BOOL& bChangePass); Параметры
Возвращаемое значение
CNetUsers::DisableUser
Функция DisableUser блокирует пользовательский аккаунт. DWORD DisableUser(CString strUserName, BOOL bDisable = TRUE); DWORD DisableUser(BOOL bDisable = TRUE); Параметры
Возвращаемое значение
CNetUsers::GetUserInfo
Функция GetUserInfo позволяет получить информацию о пользователе. DWORD GetUserInfo(CString strUserName, CNetUserInfo* pUserInfo); DWORD GetUserInfo(CNetUserInfo* pUserInfo); Параметры
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);
Возвращаемое значение
CNetUsers::SetFullName
Функция SetFullName устанавливает полное имя пользователя. DWORD SetFullName(CString strUserName, CString strFullName); DWORD SetFullName(CString strFullName); Параметры
Возвращаемое значение
CNetUsers::GetFullName
Функция GetFullName позволяет получить Полное имя пользователя. DWORD GetFullName(CString strUserName, CString& strFullName); DWORD GetFullName(CString& strFullName); Параметры
Возвращаемое значение
CNetUsers::SetComment
Функция SetComment устанавлявает комментарии пользователя. DWORD SetComment(CString strUserName, CString strComment); DWORD SetComment(CString strComment); Параметры
Возвращаемое значение
CNetUsers::GetComment
Функция GetComment позволяет получить комментарии пользователя. DWORD GetComment(CString strUserName, CString& strComment); DWORD GetComment(CString& strComment); Параметры
Возвращаемое значение
CNetUsers::SetHomeDirectory
Функция SetHomeDirectory устанавливает домашнюю директорию (Home Directory) пользователя. DWORD SetHomeDirectory(CString strUserName, CString strHomeDirectory); DWORD SetHomeDirectory(CString strHomeDirectory); Параметры
Возвращаемое значение
CNetUsers::GetHomeDirectory
Функция GetHomeDirectory позволяет получить домашнюю директорию (Home Directory) пользователя. DWORD GetHomeDirectory(CString strUserName, CString& strHomeDirectory); DWORD GetHomeDirectory(CString& strHomeDirectory); Параметры
Возвращаемое значение
CNetUsers::SetHomeDirDrive
Функция SetHomeDirDrive устанавливает букву диска, связанную с домашней директорией пользователя при входе в систему. DWORD SetHomeDirDrive(CString strUserName, CString strHomeDirDrive); DWORD SetHomeDirDrive(CString strHomeDirDrive); Параметры
Возвращаемое значение
CNetUsers::GetHomeDirDrive
Функция GetHomeDirDrive позволяет получить букву диска, связанную с домашней директорией пользователя при входе в систему. DWORD GetHomeDirDrive(CString strUserName, CString& strHomeDirectory); DWORD GetHomeDirDrive(CString& strHomeDirectory); Параметры
Возвращаемое значение
CNetUsers::SetUserPrivilege
Функция SetUserPrivilege позволяет установить привелегии пользователя. DWORD SetUserPrivilege(CString strUserName, int nPrivilege); DWORD SetUserPrivilege(int nPrivilege); Параметры
CNetUsers::usrPrivGuest Гость Возвращаемое значение
CNetUsers::GetUserPrivilege
Функция GetUserPrivilege позволяет узнать привелегии пользователя. DWORD GetUserPrivilege(CString strUserName, int& nPrivilege); DWORD GetUserPrivilege(int& nPrivilege); Параметры
Возвращаемое значение
CNetUsers::SetOperatorPrivilege
The SetOperatorPrivilege function specifies the user's operator privileges assigned to a user network account. DWORD SetOperatorPrivilege(CString strUserName, int nPrivileges); DWORD SetOperatorPrivilege(int nPrivileges); Параметры
CNetUers::opPrivPrint The
print operator privilege is enabled.
CNetUsers::GetOperatorPrivilege
The GetOperatorPrivilege function retrieves the user's operator privileges assigned to a user network account. DWORD GetOperatorPrivilege(CString strUserName, int& nPrivileges); DWORD GetOperatorPrivilege(int& nPrivileges); Параметры
Возвращаемое значение
CNetUsers::SetNotChangePass
Функция SetNotChangePass устанавливает - может ли пользователь менять пароль. DWORD SetNotChangePass(CString strUserName, BOOL bPermit = FALSE); DWORD SetNotChangePass(BOOL bPermit = FALSE); Параметры
Возвращаемое значение
CNetUsers::GetNotChangePass
Функция GetNotChangePass позволяет узнать - может ли пользователь менять пароль. DWORD GetNotChangePass(CString strUserName, BOOL& bNotPermit); DWORD GetNotChangePass(BOOL& bNotPermit); Параметры
Возвращаемое значение
CNetUsers::SetWorkStations
Функция SetWorkStations устанавливает имена рабочих станций, с которых пользователь может логиниться. DWORD SetWorkStations(CString strUserName, CString strWorkStations); DWORD SetWorkStations(CString strWorkStations); Параметры
Например: pUsers.SetWorkStations("pc1,pc2,pc3");
pUsers.SetWorkStations("");
Возвращаемое значение
CNetUsers::GetWorkStations
Функция GetWorkStations позволяет узнать, с каких рабочих станций можно пользователю логиниться. DWORD GetWorkStations(CString strUserName, CString& strWorkStations); DWORD GetWorkStations(CString& strWorkStations); Параметры
Возвращаемое значение
CNetUsers::GetBadPasswordCount
Функция GetBadPasswordCount позволяет узнать - сколько раз пользователь ввёл неправильно пароль при входе в систему. DWORD GetBadPasswordCount(CString strUserName, long& nCount); DWORD GetBadPasswordCount(long& nCount); Параметры
Возвращаемое значение
CNetUsers::GetLogonCount
Функция GetLogonCount возвращает количество удачных входов в систему для данного аккаунта. DWORD GetLogonCount(CString strUserName, long& nCount); DWORD GetLogonCount(long& nCount); Параметры
Возвращаемое значение
CNetUsers::GetPasswordAge
Функция GetPasswordAge возвращает количество секунд с момента, когда пользователь последний раз изменил пароль. DWORD GetPasswordAge(CString strUserName, DWORD& nSeconds); DWORD GetPasswordAge(DWORD& nSeconds); Параметры
Возвращаемое значение
CNetUsers::IsUserDisable
Функция IsUserDisable позволяет узнать - заблокирован ли аккаунт пользователя. DWORD IsUserDisable(CString strUserName, BOOL& bDisable); DWORD IsUserDisable(BOOL& bDisable); Параметры
Возвращаемое значение
CNetUsers::QueryFirstUser
Функция QueryFirstUser возвращает информацию о пользовательском аккаунте. DWORD QueryFirstUser(CString& strUserName, BOOL& bMoreData); Параметры
Возвращаемое значение
CNetUsers::QueryNextUser
Функция QueryNextUser возвращает информацию о пользовательском аккаунте. DWORD QueryNextUser(CString& strUserName, BOOL& bMoreData); Параметры
Возвращаемое значение
CNetUsers::FindFirstUser
Функция FindFirstUser позволяет получить информацию о всех пользовательских аккаунтах на сервере. DWORD FindFirstUser(CString& strUserName, BOOL& bMoreData); DWORD FindFirstUser(BOOL& bMoreData); Параметры
Возвращаемое значение
CNetUsers::FindNextUser
Функция FindNextUser позволяет получить информацию о всех пользовательских аккаунтах на сервере. DWORD FindNextUser(CString& strUserName, BOOL& bMoreData); DWORD FindNextUser(BOOL& bMoreData); Параметры
Возвращаемое значение
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(); Параметры
CNetGroups::GetGroup
Функция GetGroup возвращает имя глобальной группы в объекте CNetGroups. CString GetGroup(); Возвращаемое значение Строка с именем глобальной группы.
CNetGroups::Add
Функция Add создаёт глобальную группу. DWORD Add(CString strGroupName, CString strComments = _T(""));
Параметры
Возвращаемое значение
CNetGroups::AddUser
Функция AddUser добавляет существующего пользователя в существующую глобальную группу. DWORD AddUser(CString strGroupName, CString strUserName); DWORD AddUser(CString strUserName); Параметры
Возвращаемое значение
CNetGroups::DeleteUser
Функция DeleteUser удаляет пользователя из определённой глобальной группы. DWORD DeleteUser(CString strGroupName, CString strUserName); DWORD DeleteUser(CString strUserName); Параметры
Возвращаемое значение
CNetGroups::Delete
Функция Delete удаляет глобальную группу. DWORD Delete(); DWORD Delete(CString strGroupName); Параметры
Возвращаемое значение
CNetGroups::FindFirstGroup
Функция FindFirstGroup позволяет получить информацию о каждой глобальной группе. DWORD FindFirstGroup(CString& strGroupName, BOOL& bMoreData); DWORD FindFirstGroup(BOOL& bMoreData); Параметры
Возвращаемое значение
CNetGroups::FindNextGroup
Функция FindNextGroup позволяет получить информацию о каждой глобальной группе. DWORD FindNextGroup(CString& strGroupName, BOOL& bMoreData); DWORD FindNextGroup(BOOL& bMoreData); Параметры
Возвращаемое значение
CNetGroups::FindFirstUser
The FindFirstUser function retrieves information about each user in a global group account. DWORD FindFirstUser(CString strGroupName, CString& strUserName, BOOL& bMoreData); DWORD FindFirstUser(CString& strUserName, BOOL& bMoreData); Параметры
Возвращаемое значение
CNetGroups::FindNextUser
The FindNextUser function retrieves information about each user in a global group account. DWORD FindNextUser(CString& strUserName, BOOL& bMoreData); Параметры
Возвращаемое значение
CNetGroups::SetGroup
Функция SetGroup устанавливает текущую глобальную группу. void SetGroup(CString strGroupName);
Параметры
CNetGroups::GetGroup
Функция GetGroup возвращает имя текущей глобальной группы. CString GetGroup(); Возвращаемое значение строка с именем глобальной группы.
CNetGroups::m_strErrorОписание: m_strError содержит строку с последней ошибкой.
Класс CNetLocalGroups
CNetLocalGroups::CNetLocalGroups
Конструктор CNetLocalGroups . CNetLocalGroups(CNetDomain pDomain); CNetLocalGroups(); Параметры
CNetLocalGroups::GetGroup
Функция GetGroup возвращает имя локальной группы в объекте CNetLocalGroups. CString GetGroup(); Возвращаемое значение Функция возвращает строку с именем локальной группы.
CNetLocalGroups::Add
Функция Add создаёт локальную группу. DWORD Add(CString strLocalGroupName, CString strComments = _T(""));
Параметры
Возвращаемое значение
CNetLocalGroups::AddUser
Функция AddUser добавляет существующего пользователя в существующую локальную группу. DWORD AddUser(CString strLocalGroupName, CString strUserName); DWORD AddUser(CString strUserName); Параметры
Возвращаемое значение
CNetLocalGroups::DeleteUser
Функция DeleteUser удаляет пользователя из локальной группы. DWORD DeleteUser(CString strLocalGroupName, CString strUserName); DWORD DeleteUser(CString strUserName); Параметры
Возвращаемое значение
CNetLocalGroups::Delete
Функция Delete удаляет локальную группу. DWORD Delete(); DWORD Delete(CString strLocalGroupName); Параметры
Возвращаемое значение
CNetLocalGroups::FindFirstGroup
The FindFirstGroup function retrieves information about each local group in the security database. DWORD FindFirstGroup(CString& strLocalGroupName, BOOL& bMoreData); DWORD FindFirstGroup(BOOL& bMoreData); Параметры
Возвращаемое значение
CNetLocalGroups::FindNextGroup
The FindNextGroup function retrieves information about each local group in the security database. DWORD FindNextGroup(CString& strLocalGroupName, BOOL& bMoreData); DWORD FindNextGroup(BOOL& bMoreData); Параметры
Возвращаемое значение
CNetLocalGroups::FindFirstUser
The FindFirstUser function retrieves information about each user in a local group account. DWORD FindFirstUser(CString strLocalGroupName, CString& strUserName, BOOL& bMoreData); DWORD FindFirstUser(CString& strUserName, BOOL& bMoreData); Параметры
Возвращаемое значение
CNetLocalGroups::FindNextUser
The FindNextUser function retrieves information about each user in a local group account. DWORD FindNextUser(CString& strUserName, BOOL& bMoreData); Параметры
Возвращаемое значение
CNetLocalGroups::SetGroup
Функция SetGroup устанавливает текущую локальную группу. void SetGroup(CString strLocalGroupName);
Параметры
CNetLocalGroups::GetGroup
Функция GetGroup возвращает имя текущей локальной группы. CString GetGroup(); Возвращаемое значение Строка с именем локальной группы.
CNetLocalGroups::m_strErrorОписание: m_strError содержит строку с последней ошибкой.
|