///<summary>
/// Lists all computers of the specified type or types that are visible
/// in the specified domain. It may also enumerate domains.
///</summary>
///<param name = "domain">The name of the workgroup in which to enumerate computers
/// of the specified type or types. If domain is null, servers
/// are enumerated for the current domain of the computer</param>
///<param name = "types">The type or types o fcoimputer to enumerate. Computers that match
/// at least one of the specified types are returned (SV_*)</param>
///<returns><code>System.String</code> (sorted)</returns>
public string[] ListServersNames(string domain, uint types)
{
lock (this)
{
if (Debug.DebugOn)
{
Debug.WriteLine(Debug.Info, "listServersNames");
}
var param = new MarshalBuffer(100);
var data = new MarshalBuffer(1000);
// Level 0
DoNetServerEnum2(domain, types, 0, param, data);
int pos = 0;
pos += 2;
// converter
int converter = param.GetShortAt(pos);
pos += 2;
// number of entries
int counter = param.GetShortAt(pos);
pos += 2;
int maxcounter = param.GetShortAt(pos);
pos += 2;
if (maxcounter > counter)
{
if (Debug.DebugOn)
{
Debug.WriteLine(Debug.Warning, "The buffer for NetServerEnum2 was too small.");
}
}
/*
* struct SERVER_INFO_0 {
* char sv0_name[16];
* };
*/
var names = new string[counter];
for (int i = 0; i < counter; i++)
{
names[i] = data.GetZtAsciiStringAt(pos, i * 16);
}
Util.Util.SortStrings(names);
return(names);
} // lock
}
/// <summary>
/// Returns detailed information about a particular user
/// </summary>
/// <param name = "user">User Name</param>
/// <returns>user information</returns>
public CifsUserInfo GetUserInfo(string user)
{
if (Debug.DebugOn)
{
Debug.WriteLine(Debug.Info, "IPC:NetUserGetInfo");
}
var param = new MarshalBuffer(100);
int pos = 0;
pos += param.SetShortAt(pos, NetUserGetInfo);
// parameter descriptor string
pos += param.SetZtAsciiStringAt(pos, "zWrLh");
// he data descriptor string for the (returned) data which is "B21BzzzWDDzzDDWWzWzDWb21W"
pos += param.SetZtAsciiStringAt(pos, "B21BzzzWDDzzDDWWzWzDWb21W");
// user
pos += param.SetZtAsciiStringAt(pos, user);
// corresponding to the "W"
pos += param.SetShortAt(pos, 11);
// buffer size
pos += param.SetShortAt(pos, fReturnBufferSize);
param.Size = pos;
SendTransaction(null, "\\PIPE\\LANMAN", param, null, 0);
var data = new MarshalBuffer(1000);
receiveTransaction(param, data);
pos = 0;
int error = param.GetShortAt(pos);
// ignore more data
if (error != 0 && error != 234)
{
throw CifsIoException.getLMException(error);
}
pos += 2;
// converter
int converter = param.GetShortAt(pos);
pos += 2;
/* A 16 bit number representing the total number of available bytes.
* This has meaning only if the return status is NERR_Success or
* ERROR_MORE_DATA. Upon success, this number indicates the number of
* useful bytes available. Upon failure, this indicates how big the
* receive buffer needs to be.
*/
int bytes = param.GetShortAt(pos);
pos += 2;
/*
* struct user_info_11 {
* char usri11_name[21];
* char usri11_pad;
* char *usri11_comment;
* char *usri11_usr_comment;
* char *usri11_full_name;
* unsigned short usri11_priv;
* unsigned long usri11_auth_flags;
* long usri11_password_age;
* char *usri11_homedir;
* char *usri11_parms;
* long usri11_last_logon;
* long usri11_last_logoff;
* unsigned short usri11_bad_pw_count;
* unsigned short usri11_num_logons;
* char *usri11_logon_server;
* unsigned short usri11_country_code;
* char *usri11_workstations;
* unsigned long usri11_max_storage;
* unsigned short usri11_units_per_week;
* unsigned char *usri11_logon_hours;
* unsigned short usri11_code_page;
*
* };
*/
if (Debug.DebugOn)
{
data.debug("NetUserGetInfo data");
}
var info = new CifsUserInfo();
pos = 0;
// user name for which information is retireved
info.UserName = data.GetZtAsciiStringAt(pos, 21);
pos += 21;
// pad
pos++;
//comment
int ptr = data.GetIntAt(pos) & 0xffff;
pos += 4;
info.Comment = data.GetZtAsciiStringAt(ptr - converter, bytes);
// comment about user
ptr = data.GetIntAt(pos) & 0xffff;
pos += 4;
info.UserComment = data.GetZtAsciiStringAt(ptr - converter, bytes);
// full name of the user
ptr = data.GetIntAt(pos) & 0xffff;
pos += 4;
info.FullUserName = data.GetZtAsciiStringAt(ptr - converter, bytes);
// level of the privilege assigned to the user
info.UserPrivilege = data.GetShortAt(pos);
pos += 2;
// account operator privileges.
info.OperatorPrivileges = data.GetIntAt(pos);
pos += 4;
// how many seconds have elapsed since the password was last changed.
info.PasswordAge = data.GetIntAt(pos) & 0xffffffff;
pos += 4;
// path name of the user's home directory.
ptr = data.GetIntAt(pos) & 0xffff;
pos += 4;
info.HomeDir = data.GetZtAsciiStringAt(ptr - converter, bytes);
// skip usri11_parms
pos += 4;
// last logon
info.fLastLogon = data.GetIntAt(pos) & 0xffffffff;
pos += 4;
// last logon
info.fLastLogoff = data.GetIntAt(pos) & 0xffffffff;
pos += 4;
// bad logons
info.BadLogons = data.GetShortAt(pos);
pos += 2;
// num logons
info.Logons = data.GetShortAt(pos);
pos += 2;
// logon server
ptr = data.GetIntAt(pos) & 0xffff;
pos += 4;
info.LogonServer = data.GetZtAsciiStringAt(ptr - converter, bytes);
return(info);
}
// Several functions relating to printing have been ommited for now
///<summary>
/// Lists all computers of the specified type or types that are visible
/// in the specified domain. It may also enumerate domains.
///</summary>
///<param name = "domain">The name of the workgroup in which to enumerate computers
/// of the specified type or types. If domain is nul, servers
/// are enumerated for the current domain of the computer</param>
///<param name = "types">The type or types of computer to enumerate. Computers that
/// match at least one of the specified types are returned (SV_*)</param>
public CifsServerInfo[] ListServersInfo(string domain, uint types)
{
if (Debug.DebugOn)
{
Debug.WriteLine(Debug.Info, "listServersInfo");
}
var param = new MarshalBuffer(100);
var data = new MarshalBuffer(1000);
DoNetServerEnum2(domain, types, 1, param, data);
int pos = 0;
pos += 2;
// converter
int converter = param.GetShortAt(pos);
pos += 2;
// number of entries
int counter = param.GetShortAt(pos);
pos += 2;
int maxcounter = param.GetShortAt(pos);
pos += 2;
if (maxcounter > counter)
{
if (Debug.DebugOn)
{
Debug.WriteLine(Debug.Warning, "The buffer for NetServerEnum2 was too small.");
}
}
/*
* struct SERVER_INFO_1 {
* char sv1_name[16];
* char sv1_version_major;
* char sv1_version_minor;
* unsigned long sv1_type;
* char *sv1_comment_or_master_browser;
* };
*/
var infolist = new CifsServerInfo[counter];
pos = 0;
for (int i = 0; i < counter; i++)
{
var info = new CifsServerInfo();
info.ComputerName = data.GetZtAsciiStringAt(pos, 16);
pos += 16;
info.MajorVersion = data.GetByteAt(pos) & 0xff;
pos += 1;
info.MinorVersion = data.GetByteAt(pos) & 0xff;
pos += 1;
info.ServerType = (UInt32)(data.GetIntAt(pos));
pos += 4;
int rptr = (data.GetIntAt(pos) & 0xffff);
pos += 4;
if (rptr != 0)
{
info.Comment = data.GetZtAsciiStringAt(rptr - converter, 255);
}
infolist[i] = info;
}
return(infolist);
}
/// <summary>
/// Returns the list of shares on the computer
/// </summary>
/// <param name = "sort">if true, the names are sorted</param>
/// <returns>list of <code>CifsShareInfo</code> objects</returns>
public CifsShareInfo[] ListSharesInfo(bool sort)
{
lock (this)
{
if (Debug.DebugOn)
{
Debug.WriteLine(Debug.Info, "IPC:NetShareEnum");
}
var param = new MarshalBuffer(100);
int pos = 0;
pos += param.SetShortAt(pos, NetShareEnum);
// parameter descriptor string
pos += param.SetZtAsciiStringAt(pos, "WrLeh");
// The data descriptor string for the (returned) data which is "B13BWz"
pos += param.SetZtAsciiStringAt(pos, "B13BWz");
// corresponding to the "W"
pos += param.SetShortAt(pos, 1);
// buffer size
pos += param.SetShortAt(pos, fReturnBufferSize);
param.Size = pos;
SendTransaction(null, "\\PIPE\\LANMAN", param, null, 0);
var data = new MarshalBuffer(1000);
receiveTransaction(param, data);
pos = 0;
int error = param.GetShortAt(pos);
// ignore more data
if (error != 0 && error != 234)
{
throw CifsIoException.getLMException(error);
}
pos += 2;
// converter
int converter = param.GetShortAt(pos);
pos += 2;
// number of entries
int counter = param.GetShortAt(pos);
pos += 2;
// number max of entries
int maxcounter = param.GetShortAt(pos);
/*
* The SHARE_INFO_1 structure is defined as:
*
* struct SHARE_INFO_1 {
* char shi1_netname[13]
* char shi1_pad;
* unsigned short shi1_type
* char *shi1_remark;
* }
*
* where:
*
* shi1_netname contains a null terminated ASCII string that
* specifies the share name of the resource.
*
* shi1_pad aligns the next data strructure element to a word
* boundary.
*
* shi1_type contains an integer that specifies the type of the
* shared resource.
*
*
* shi1_remark points to a null terminated ASCII string that contains
* a comment abthe shared resource. The value for shi1_remark is null
* for ADMIN$ and IPC$ share names. The shi1_remark pointer is a 32
* bit pointer. The higher 16 bits need to be ignored. The converter
* word returned in the parameters section needs to be subtracted
* from the lower 16 bits to calculate an offset into the return
* buffer where this ASCII string resides.
*
* In case there are multiple SHARE_INFO_1 data structures to return,
* the server may put all these fixed length structures in the return
* buffer, leave some space and then put all the variable length data
* (the actual value of the shi1_remark strings) at the end of the
* buffer.
*/
if (Debug.DebugOn)
{
data.debug("NetShareEnum data");
}
var result = new CifsShareInfo[counter];
CifsShareInfo info;
pos = 0;
for (int i = 0; i < counter; i++)
{
info = new CifsShareInfo(fShare.HostName);
// shil_netname[13]
info.ShareName = data.GetZtAsciiStringAt(pos, 13);
pos += 13;
pos += 1; // pad
// shil_type
info.ShareType = data.GetShortAt(pos);
pos += 2;
// shil_remark
int rptr = (data.GetIntAt(pos) & 0xffff);
pos += 4;
info.Remark = data.GetZtAsciiStringAt(rptr - converter, 255);
result[i] = info;
}
if (sort)
{
Util.Util.Sort(result, GetShareInfoComparator());
}
return(result);
} // lock
}