KITLRegisterClient (Compact 2013)
3/26/2014
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; must be set to 0 (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 |