Share via


KITLRegisterClient (Windows Embedded CE 6.0)

1/5/2010

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

Syntax

KITLID KITLRegisterClient(
  LPCWSTR pszDevName,
  LPCWSTR pszSvcName,
  DWORD dwTimeout,
  DWORD dwFlags
);

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 Value

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

Header kitlclnt.h
Library kitldll.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

KITL Transport Functions
KITLWaitForSvcConnect