IServerClientVBA::Initialize method

---

Initializes the IServerClientVBA class and puts necessary variables used by the object. This method must be called before calls of all other methods of the IServerClientVBA interface.

Public Sub Initialize(
    ByRef ServerAddress As String,
    ByRef ServerPort As Integer,
    ByRef Client As ClientType,
    ByRef WindowHandlePtr As Long,
    ByRef ResultCode As Long
)

Parameters

ServerAddress

[in] String variable that contains the name or address of the IM server. The address can be IP address or DNS name of a computer.

ServerPort

[in] Integer variable that specifies TCP/IP port on the IM server to connect to. Set this parameter to 0 value to use default port.

Client

[in] Type of the messaging client. Depending on this parameter the IM server performs or does not some operations, data delivery, etc. This parameter can be one of the following values:

ClientType.ClientType_Full

Indicates a full-featured client which can send and receive instant messages, operate with contacts, groups, etc.

ClientType.ClientType_Oneway

Indicates a one-way messenger client that can only receive messages. Operations with contacts and groups are not allowed.

WindowHandlePtr

[in] A pointer to a handle of the window that should receive all notifications and messages sent from the IM server.

ResultCode

[out] Variable of Long type that gets an extended code if error result is returned. For available codes see Available Extended Codes topic.

Return Value

S_OK

The function was successful.

E_INVALIDARG

One or more arguments are incorrect.

E_FAIL

Some error occurred in the function. Check ResultCode variable to get extended information on the error.