/// <summary>
/// Requests the alias assigned to an ICQ account
/// </summary>
/// <param name="sess">A <see cref="ISession"/> object</param>
/// <param name="screenname">The account for which to retrieve information</param>
public static void GetAlias(ISession sess, string screenname)
{
if (!ScreennameVerifier.IsValidICQ(screenname))
{
throw new ArgumentException(screenname + " is not a valid ICQ screenname", "screenname");
}
SNACHeader sh = new SNACHeader();
sh.FamilyServiceID = (ushort) SNACFamily.ICQExtensionsService;
sh.FamilySubtypeID = (ushort) ICQExtensionsService.MetaInformationRequest;
sh.Flags = 0x0000;
sh.RequestID = Session.GetNextRequestID();
ByteStream stream = new ByteStream();
stream.WriteUshort(0x0001);
stream.WriteUshort(0x000A);
stream.WriteUshort(0x0008);
stream.WriteUint(uint.Parse(sess.ScreenName));
stream.WriteUshortLE(0x07D0);
stream.WriteUshortLE((ushort) sh.RequestID);
stream.WriteUshort(0x04BA);
stream.WriteUint(uint.Parse(screenname));
SNACFunctions.BuildFLAP(Marshal.BuildDataPacket(sess, sh, stream));
}
/// <summary>
/// Requests a full set of information about an ICQ account
/// </summary>
/// <param name="sess">A <see cref="ISession"/> object</param>
/// <param name="screenname">The account for which to retrieve information</param>
public static void GetAllICQInfo(ISession sess, string screenname)
{
if (!ScreennameVerifier.IsValidICQ(screenname))
{
throw new ArgumentException(screenname + " is not a valid ICQ screenname", "screenname");
}
SNACHeader sh = new SNACHeader();
sh.FamilyServiceID = (ushort)SNACFamily.ICQExtensionsService;
sh.FamilySubtypeID = (ushort)ICQExtensionsService.MetaInformationRequest;
sh.Flags = 0x0000;
sh.RequestID = Session.GetNextRequestID();
ByteStream stream = new ByteStream();
stream.WriteUshort(0x0001);
stream.WriteUshort(0x000A);
stream.WriteUshort(0x0008);
stream.WriteUint(uint.Parse(sess.ScreenName));
stream.WriteUshortLE(0x07D0);
stream.WriteUshortLE((ushort)sh.RequestID);
stream.WriteUshort(0x04B2);
stream.WriteUint(uint.Parse(screenname));
SNACFunctions.BuildFLAP(Marshal.BuildDataPacket(sess, sh, stream));
}
/// <summary>
/// Sends an out-of-the-country text message
/// </summary>
/// <param name="sess">A <see cref="ISession"/> object</param>
/// <param name="number">The number to which to send the message</param>
/// <param name="message">The message to send</param>
/// <param name="alias">The sender's alias</param>
/// <remarks><paramref name="message"/> must be in codepage 1252. A delivery receipt
/// is automatically requested by this method.</remarks>
public static void SendSMSMessage(ISession sess, string number, string message, string alias)
{
string xmlformat = "<icq_sms_message>\n" +
"\t<destination>{0}</destination>\n" +
"\t<text>{1}</text>\n" +
"\t<codepage>1252</codepage>\n" +
"\t<senders_UIN>{2}</senders_UIN>\n" +
"\t<senders_name>{3}</senders_name>\n" +
"\t<delivery_receipt>Yes</delivery_receipt>\n" +
"\t<time>{4}</time>\n" +
"</icq_sms_message>\n";
string xml = String.Format(xmlformat,
number,
message,
sess.ScreenName,
alias,
DateTime.Now.ToString("r"));
SNACHeader sh = new SNACHeader();
sh.FamilyServiceID = (ushort)SNACFamily.ICQExtensionsService;
sh.FamilySubtypeID = (ushort)ICQExtensionsService.MetaInformationRequest;
sh.Flags = 0x0000;
sh.RequestID = Session.GetNextRequestID();
ByteStream stream = new ByteStream();
stream.WriteUshort(0x0001);
stream.WriteUshort(0x000A);
stream.WriteUshort(0x0008);
stream.WriteUint(uint.Parse(sess.ScreenName));
stream.WriteUshortLE(0x07D0);
stream.WriteUshortLE((ushort)sh.RequestID);
stream.WriteUshort(0x8214);
stream.WriteUshort(0x0001);
stream.WriteUshort(0x0016);
stream.WriteUint(0x00000000);
stream.WriteUint(0x00000000);
stream.WriteUint(0x00000000);
stream.WriteUint(0x00000000);
stream.WriteUshort(0x0000);
stream.WriteUshort((ushort)Encoding.ASCII.GetByteCount(xml));
stream.WriteString(xml, Encoding.ASCII);
stream.WriteByte(0x00);
SNACFunctions.BuildFLAP(Marshal.BuildDataPacket(sess, sh, stream));
}
/// <summary>
/// Changes the password on an ICQ account
/// </summary>
/// <param name="sess">A <see cref="ISession"/> object</param>
/// <param name="newpassword">The new password</param>
/// <remarks>If the new password is longer than 8 characters, it is automatically
/// truncated to 8 characters by the server.</remarks>
public static void ChangeICQPassword(ISession sess, string newpassword)
{
SNACHeader sh = new SNACHeader();
sh.FamilyServiceID = (ushort) SNACFamily.ICQExtensionsService;
sh.FamilySubtypeID = (ushort) ICQExtensionsService.MetaInformationRequest;
sh.Flags = 0x0000;
sh.RequestID = Session.GetNextRequestID();
ByteStream stream = new ByteStream();
stream.WriteUshort(0x0001);
stream.WriteUshort(0x000A);
stream.WriteUshort(0x0008);
stream.WriteUint(uint.Parse(sess.ScreenName));
stream.WriteUshortLE(0x07D0);
stream.WriteUshortLE((ushort) sh.RequestID);
stream.WriteUshort(0x042E);
stream.WriteUshort((ushort) (newpassword.Length + 1));
stream.WriteString(newpassword, Encoding.ASCII);
stream.WriteByte(0x00);
SNACFunctions.BuildFLAP(Marshal.BuildDataPacket(sess, sh, stream));
}
/// <summary>
/// Hides the client's IP address from view
/// </summary>
/// <param name="sess">A <see cref="ISession"/> object</param>
public static void HidePublicIP(ISession sess)
{
SNACHeader sh = new SNACHeader();
sh.FamilyServiceID = (ushort)SNACFamily.ICQExtensionsService;
sh.FamilySubtypeID = (ushort)ICQExtensionsService.MetaInformationRequest;
sh.Flags = 0x0000;
sh.RequestID = Session.GetNextRequestID();
ByteStream stream = new ByteStream();
stream.WriteUshort(0x0001);
stream.WriteUshort(0x000A);
stream.WriteUshort(0x0008);
stream.WriteUint(uint.Parse(sess.ScreenName));
stream.WriteUshortLE(0x07D0);
stream.WriteUshortLE((ushort)sh.RequestID);
stream.WriteUshort(0x0424);
stream.WriteUshort(0x0001);
stream.WriteUshort(0x0001);
SNACFunctions.BuildFLAP(Marshal.BuildDataPacket(sess, sh, stream));
}
/// <summary>
/// Changes the password on an ICQ account
/// </summary>
/// <param name="sess">A <see cref="ISession"/> object</param>
/// <param name="newpassword">The new password</param>
/// <remarks>If the new password is longer than 8 characters, it is automatically
/// truncated to 8 characters by the server.</remarks>
public static void ChangeICQPassword(ISession sess, string newpassword)
{
SNACHeader sh = new SNACHeader();
sh.FamilyServiceID = (ushort)SNACFamily.ICQExtensionsService;
sh.FamilySubtypeID = (ushort)ICQExtensionsService.MetaInformationRequest;
sh.Flags = 0x0000;
sh.RequestID = Session.GetNextRequestID();
ByteStream stream = new ByteStream();
stream.WriteUshort(0x0001);
stream.WriteUshort(0x000A);
stream.WriteUshort(0x0008);
stream.WriteUint(uint.Parse(sess.ScreenName));
stream.WriteUshortLE(0x07D0);
stream.WriteUshortLE((ushort)sh.RequestID);
stream.WriteUshort(0x042E);
stream.WriteUshort((ushort)(newpassword.Length + 1));
stream.WriteString(newpassword, Encoding.ASCII);
stream.WriteByte(0x00);
SNACFunctions.BuildFLAP(Marshal.BuildDataPacket(sess, sh, stream));
}
/// <summary>
/// Sends an XML string
/// </summary>
/// <param name="sess">A <see cref="ISession"/> object</param>
/// <param name="xml">The contents of an XML document</param>
/// <remarks>I have no idea how to use this.</remarks>
public static void SendXmlRequest(ISession sess, string xml)
{
SNACHeader sh = new SNACHeader();
sh.FamilyServiceID = (ushort)SNACFamily.ICQExtensionsService;
sh.FamilySubtypeID = (ushort)ICQExtensionsService.MetaInformationRequest;
sh.Flags = 0x0000;
sh.RequestID = Session.GetNextRequestID();
ByteStream stream = new ByteStream();
stream.WriteUshort(0x0001);
stream.WriteUshort(0x000A);
stream.WriteUshort(0x0008);
stream.WriteUint(uint.Parse(sess.ScreenName));
stream.WriteUshortLE(0x07D0);
stream.WriteUshortLE((ushort)sh.RequestID);
stream.WriteUshort(0x0998);
stream.WriteUshort((ushort)Encoding.ASCII.GetByteCount(xml));
stream.WriteString(xml, Encoding.ASCII);
stream.WriteByte(0x00);
SNACFunctions.BuildFLAP(Marshal.BuildDataPacket(sess, sh, stream));
}
/// <summary>
/// Sends an XML string
/// </summary>
/// <param name="sess">A <see cref="ISession"/> object</param>
/// <param name="xml">The contents of an XML document</param>
/// <remarks>I have no idea how to use this.</remarks>
public static void SendXmlRequest(ISession sess, string xml)
{
SNACHeader sh = new SNACHeader();
sh.FamilyServiceID = (ushort) SNACFamily.ICQExtensionsService;
sh.FamilySubtypeID = (ushort) ICQExtensionsService.MetaInformationRequest;
sh.Flags = 0x0000;
sh.RequestID = Session.GetNextRequestID();
ByteStream stream = new ByteStream();
stream.WriteUshort(0x0001);
stream.WriteUshort(0x000A);
stream.WriteUshort(0x0008);
stream.WriteUint(uint.Parse(sess.ScreenName));
stream.WriteUshortLE(0x07D0);
stream.WriteUshortLE((ushort) sh.RequestID);
stream.WriteUshort(0x0998);
stream.WriteUshort((ushort) Encoding.ASCII.GetByteCount(xml));
stream.WriteString(xml, Encoding.ASCII);
stream.WriteByte(0x00);
SNACFunctions.BuildFLAP(Marshal.BuildDataPacket(sess, sh, stream));
}
/// <summary>
/// Sends an out-of-the-country text message
/// </summary>
/// <param name="sess">A <see cref="ISession"/> object</param>
/// <param name="number">The number to which to send the message</param>
/// <param name="message">The message to send</param>
/// <param name="alias">The sender's alias</param>
/// <remarks><paramref name="message"/> must be in codepage 1252. A delivery receipt
/// is automatically requested by this method.</remarks>
public static void SendSMSMessage(ISession sess, string number, string message, string alias)
{
string xmlformat = "<icq_sms_message>\n" +
"\t<destination>{0}</destination>\n" +
"\t<text>{1}</text>\n" +
"\t<codepage>1252</codepage>\n" +
"\t<senders_UIN>{2}</senders_UIN>\n" +
"\t<senders_name>{3}</senders_name>\n" +
"\t<delivery_receipt>Yes</delivery_receipt>\n" +
"\t<time>{4}</time>\n" +
"</icq_sms_message>\n";
string xml = String.Format(xmlformat,
number,
message,
sess.ScreenName,
alias,
DateTime.Now.ToString("r"));
SNACHeader sh = new SNACHeader();
sh.FamilyServiceID = (ushort) SNACFamily.ICQExtensionsService;
sh.FamilySubtypeID = (ushort) ICQExtensionsService.MetaInformationRequest;
sh.Flags = 0x0000;
sh.RequestID = Session.GetNextRequestID();
ByteStream stream = new ByteStream();
stream.WriteUshort(0x0001);
stream.WriteUshort(0x000A);
stream.WriteUshort(0x0008);
stream.WriteUint(uint.Parse(sess.ScreenName));
stream.WriteUshortLE(0x07D0);
stream.WriteUshortLE((ushort) sh.RequestID);
stream.WriteUshort(0x8214);
stream.WriteUshort(0x0001);
stream.WriteUshort(0x0016);
stream.WriteUint(0x00000000);
stream.WriteUint(0x00000000);
stream.WriteUint(0x00000000);
stream.WriteUint(0x00000000);
stream.WriteUshort(0x0000);
stream.WriteUshort((ushort) Encoding.ASCII.GetByteCount(xml));
stream.WriteString(xml, Encoding.ASCII);
stream.WriteByte(0x00);
SNACFunctions.BuildFLAP(Marshal.BuildDataPacket(sess, sh, stream));
}
/// <summary>
/// Hides the client's IP address from view
/// </summary>
/// <param name="sess">A <see cref="ISession"/> object</param>
public static void HidePublicIP(ISession sess)
{
SNACHeader sh = new SNACHeader();
sh.FamilyServiceID = (ushort) SNACFamily.ICQExtensionsService;
sh.FamilySubtypeID = (ushort) ICQExtensionsService.MetaInformationRequest;
sh.Flags = 0x0000;
sh.RequestID = Session.GetNextRequestID();
ByteStream stream = new ByteStream();
stream.WriteUshort(0x0001);
stream.WriteUshort(0x000A);
stream.WriteUshort(0x0008);
stream.WriteUint(uint.Parse(sess.ScreenName));
stream.WriteUshortLE(0x07D0);
stream.WriteUshortLE((ushort) sh.RequestID);
stream.WriteUshort(0x0424);
stream.WriteUshort(0x0001);
stream.WriteUshort(0x0001);
SNACFunctions.BuildFLAP(Marshal.BuildDataPacket(sess, sh, stream));
}