KatoSetServer

  • Article

This function specifies the location of the machine running the CETK server.

BOOL KatoSetServer(
  LPCTSTR szServer 
);

Parameters

  • szServer
    For Windows-based desktop platforms:

    Specifies the computer name or IP address of the machine that is running the Kato server. A value of NULL will cause a configuration dialog to appear that will prompt the user for a computer.

    For Windows CE:

    Specifies the computer name or IP address of the machine that is running the Kato server. A value of NULL indicates that the development workstation to which the target device is connected is the server.

Return Values

Nonzero if successful; otherwise, zero. To get extended error information, call the GetLastError function.

Remarks

With this function, Kato routes the output of all CKato objects that reside within the given process to the CETK server. All CKato objects created before and after the call to the KatoSetServer function will be routed to the server. It is recommended that the KatoSetServer function be called before any CKato objects are created to prevent the possibility of a lost log. If neither the KatoSetServer function nor KatoSetCallback is called, applications may still call CKato members, but the log will be discarded.

If the function fails, the GetLastError function will return one of the following values:

  • ERROR_OPEN_FAILED

    A socket error occurred while trying to open the connection.

  • ERROR_BAD_NET_NAME

    The machine name is invalid or the machine is not reachable.

  • ERROR_SERVER_DISABLED

    The server is disabled or not running on the machine specified.

  • ERROR_REVISION_MISMATCH

    There is a version mismatch between the CETK server and the Kato client.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Kato.h.
Link Library: Kato.lib.

See Also

KatoSetCallback

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.