srv_message_handler (API de procedimiento almacenado extendido)

Se aplica a: SQL Server

Importante

Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. En su lugar, use la integración de CLR.

Llama al controlador de mensajes de la API Procedimiento almacenado extendido instalado. Normalmente, esta función se usa para llamar a Microsoft SQL Server desde un procedimiento almacenado extendido para registrar un error (definido por el procedimiento almacenado extendido) en el archivo de registro de errores de SQL Server o en el registro de aplicaciones de Microsoft Windows.

Sintaxis

  
int srv_message_handler (  
SRV_PROC *  
srvproc  
,  
int  
errornum  
,  
BYTE   
severity  
,  
BYTE  
state  
,  
int  
oserrnum  
,  
char *  
errtext  
,  
int  
errtextlen  
,  
char *  
oserrtext  
,  
int  
oserrtextlen  
);  

Argumentos

srvproc
Es un puntero a la estructura SRV_PROC que es el identificador de una conexión cliente determinada. El parámetro srvproc contiene información que se usa para administrar la comunicación y los datos entre la aplicación y el cliente.

errornum
Es un número de error definido por el procedimiento almacenado extendido. Este número debe estar comprendido entre 50.001 y 2.147.483.647.

severity
Es un valor de gravedad estándar de SQL Server para el error. Este número debe estar comprendido entre 0 y 24.

state
Es un valor de estado de SQL Server para el error.

oserrnum
Es el número de error del sistema operativo. Este argumento se pasa por alto.

errtext
Es la descripción del error del procedimiento almacenado extendido errornum.

errtextlen
Es la longitud de la cadena del error del procedimiento almacenado extendido errtext.

oserrtext
Es la descripción del error del sistema operativo oserrnum. Este argumento se pasa por alto.

oserrtextlen
Es la longitud de la cadena de error del sistema operativo oserrtext.

Devoluciones

SUCCEED o FAIL.

Comentarios

La función srv_message_handler permite que un procedimiento almacenado extendido se integre con las características centralizadas de registro de errores e informes de SQL Server. Las alertas de SQL Server se pueden establecer para eventos de procedimientos almacenados extendidos y Agente SQL Server supervisarán estas condiciones de alerta.

Si el mensaje de error es más largo, se trunca a 412 bytes.

Importante

Debe revisar minuciosamente el código fuente de los procedimientos almacenados extendidos y debe probar las DLL compiladas antes de instalarlas en el servidor de producción. Para obtener información acerca de la revisión y pruebas de seguridad, vea este sitio web de Microsoft.