KITLRegisterClient
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
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 |