KITLRegisterClient (Windows CE 5.0)

Send Feedback

This function is called by a client application to create a KITL client that connects to a KITL server.

KITLID KITLRegisterClient(LPCWSTRpszDevName,LPCWSTRpszSvcName,DWORDdwTimeout,DWORDdwFlags);

Parameters

  • pszDevName
    [in] Pointer to the string that contains the name of the device to connect to. The maximum length is KITL_MAX_DEV_NAMELEN, including the NULL character.
  • pszSvcName
    [in] Pointer to the string that contains the name of the service that is being registered. This is a client-defined service name for which there is a device-side server to service. The name is limited to MAX_SVC_NAMELEN, including the NULL.
  • dwTimeout
    [in] Specifies the amount of time, in milliseconds, to wait for the service to be established. If the dwTimeout parameter is set to zero, KITLWaitForSvcConnect must be called when the service is established.
  • dwFlags
    [in] Reserved for future use. Must be set to zero.

Return Values

The value returned is the Kernel Independent Transport Layer (KITL) identifier associated with the KITL client. If the value is equal to INVALID_KITLID, the connection failed. For more error information, call GetLastError. A maximum of MAX_KITL_CLIENTS clients can be registered to use the KITL services at one time.

Remarks

This function is available for use by OEMs and/or tools venders to create their own service that operate through KITL.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Kitlclnt.h.
Link Library: Kitldll.lib.

See Also

KITLWaitForSvcConnect

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.