ServerMessage Event

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The ServerMessage event occurs when a Microsoft SQL Server success-with-information message is returned to the SQL Distributed Management Objects (SQL-DMO) application.

Syntax

Private Subobject_ServerMessage(Severity as Long,MessageNumber as Long,MessageState as Long,Message as String)

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

  • Severity
    Long integer that identifies the severity level of a SQL Server error message.

  • MessageNumber
    Long integer that identifies a SQL Server error message by number.

  • MessageState
    Long integer that identifies a state value for a SQL Server error message.

  • Message
    String that contains SQL Server error message text.

Prototype (C/C++)

HRESULT ServerMessage(long Severity, long MessageNumber,
long MessageState, SQLDMO_LPCSTR Message);

Remarks

For SQL Server, error severity indicates the degree of an error condition. Some errors are severe enough to terminate statement execution prematurely. Any error with a severity of 10 or higher is returned to the SQL-DMO application through normal error handling.

More benign errors indicate that statement execution succeeded, but that success was conditional. Success-with-information errors, called messages, are SQL Server errors with a severity of less than 10. Some Transact-SQL statements, such as the PRINT statement, do not generate result sets, using messages for their return value.

Implement a ServerMessage event handler to capture SQL Server messages raised by SQL-DMO application processing.

Applies To: