SRV_GOT_ATTENTION

Determines whether an attention event has occurred.

Important This Open Data Services function or macro is only supported in Microsoft® SQL Server™ version 7.0 for backward compatibility.

For more information about Open Data Services functions or macros supported for backward compatibility, see Open Data Services (Level 3).

Syntax

BOOL SRV_GOT_ATTENTION ( SRV_PROC * srvproc );

Arguments

srvproc

Is a pointer to the SRV_PROC structure that is the handle for a particular client connection (in this case, the handle receiving an attention event).

Returns

TRUE if an attention event is received; otherwise, FALSE.

Remarks

Attention events are serviced as soon as they are detected. The handler for the attention event is called automatically when an attention event is detected.

When a client sends an attention event to an Open Data Services server application, an attention flag is set in the receiving SRV_PROC structure. This flag is normally set as a result of a client call to the DB-Library function dbcancel. The attention flag is cleared when srv_senddone is called.