Compartir a través de

  • Artículo

srv_message_handler (API de procedimiento almacenado extendido)

Nota importanteImportante

Esta característica se quitará en una versión futura de Microsoft SQL Server. No utilice esta característica en nuevos trabajos de desarrollo y modifique lo antes posible las aplicaciones que actualmente la utilizan. En su lugar, use la integración CLR.

Llama al controlador de mensajes de la API Procedimiento almacenado extendido instalado. Esta función normalmente se utiliza 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 aplicación 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 utiliza para administrar comunicación y 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 de SQL Server estándar 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 de sistema operativo oserrnum. Este argumento se pasa por alto.

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

Devuelve

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 e informes de errores de SQL Server. Se pueden establecer alertas de SQL Server para eventos a partir de los procedimientos almacenados extendidos; el Agente SQL Server supervisará estas condiciones de alerta.

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

Nota de seguridadNota de seguridad

Debe revisar cuidadosamente 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.