KatoSetServer (Windows CE 5.0)

Send Feedback

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

BOOL KatoSetServer(LPCTSTRszServer ); 

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 dialog box 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

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.