LlmIsBlocking Function  
 
BOOL WINAPI LlmIsBlocking(
  HCLIENT hClient  
);

The LlmIsBlocking function is used to determine if the client is currently performing a blocking operation.

Parameters

hClient
Handle to the client session.

Return Value

If the client is performing a blocking operation, the function returns a non-zero value. If the client is not performing a blocking operation, or the client handle is invalid, the function returns zero. To get extended error information, call LlmGetLastError.

Remarks

A blocking operation may allow the application to be re-entered. For example, the user may press a button while another request is still in progress. If this causes another blocking function to be called for the same client session, the second operation will fail because only one blocking operation can be active at a time.

The LlmIsBlocking function can be used to determine if the client is already blocked, and if so, take some other action, such as warning the user that they must wait for the current operation to complete.

When a message is sent to the server using the LlmSendMessage or LlmSendMessageEx functions, the client will block until the message is sent and the server has responded, or until a timeout has occurred. If you send a request to the server in your application's main UI thread, you should present some visual indicator that the application is waiting for the operation to complete. If you need to ensure your application remains responsive while waiting for a response from the server, you can send messages using a background worker thread.

Requirements

Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cstools12.h
Import Library: csllmv12.lib

See Also

LlmCancelRequest, LlmIsConnected, LlmSendMessage, LlmSendMessageEx, LlmSetTimeout