The new official icqlib documentation.

[Anonymous]

OK, here is the official documentation for icqlib as I understand it:

1)  Create an ICQLINK by calling icq_ICQLINKNew
1a)     Set great gobs of function pointers in your new LINK,
          by simple assignment ( no functions to do this ) this
          appears to be the only way, although the header file
          says that you should treat the struct as read only.
2)  Connect using icq_Connect
3)  Log in using icq_Login
4)  Poll occasionally (how often?) using icq_Main
5)  Send a message using SendMessage when you feel like it
6)  Log off using icq_Logout
7)  Delete your link using icq

That's all I know, and I've never successfully sent a message.  Well, maybe I sent one, but by other user never received it.

Who wants to add some general comments on this subject?  I'd be happy to compile them over time into some kind of documentation, but without input, it'll take at least as long to do that as it takes to figure it out, which is probably more time than it would take you to tell me how it works!

If you post guesses, mark them as such, and I'll try to verify them before adding them.

Also, for sample code, see the other item I'm posting.

[Anonymous]

Of I forgot ... after calling one of these functions, react in some way the the 'icq_SetTimeout' callback you receive ... any body know how to react to it?  I do the following:

cout << __PRETTY_FUNCTION__ << endl;

but although that's useful to me, it probably doesn't do what the code making the callback expects.

[Denys Dmytriyenko]

Yes, it is useful for you, but not for the library... ;)

You should set timer for "interval" seconds and when it has elapsed, call icq_HandleTimeout() function.

[rihad]

Quite funny that I'm not alone with these issues... I thought it was me being stupid and
came here seeking help :))

Here's what I'm planning to investigate for a couple of days to come:

- #include "icqlib.h"
- Provide bodies for every callback defined in ICQLINK, that just print to stderr that
they were called;
- call WSAStartup (yup, I'm on windoze)
- set the global icq_LogLevel as high as possible (ICQ_LOG_MESSAGE)
- define an ICQLINK local to main() and call icq_Init(&link, 121204423, "password", "login") on it;
- call icq_Connect(&link, "icq.mirabilis.com", 4000)
- call icq_Login(&link, STATUS_ONLINE);
- call icq_SendMessage(&link, 50736787, "Hi there!", ICQ_SEND_BESTWAY);
- fail
- cleanup

Any other ideas, anyone? :)