srv_message_handler (Extended przechowywane procedury API)

Ważne:
Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Nie należy stosować tej funkcji w nowych projektach oraz jak najszybciej należy zmodyfikować aplikacje, w których obecnie jest używana ta funkcja. Użyj integracja CLR.

Wywołuje zainstalowanych obsługi wiadomości Extended API procedury przechowywane.This function is usually used to call Microsoft SQL Server from an extended stored procedure to log an error (defined by the extended stored procedure) in the SQL Server error log file or the Microsoft Windows application log.

Składnia

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

Argumenty

• srvproc
  Jest wskaźnik do struktury SRV_PROC dojście do połączenia określonego klient.srvproc Parametr zawiera informacje używane do zarządzania komunikacji i danych między aplikacją i klient.

• errornum
  Numer błędu jest zdefiniowany przez rozszerzona procedura składowana.Ta liczba musi być z zakresu od 50 001 do 2 147 483 647.

• severity
  To standard SQL Server ważności wartość błędu.Ta liczba musi być z zakresu od 0 do 24.

• state
  Jest SQL Server wartość stan błędu.

• oserrnum
  Jest to liczba błędów systemu operacyjnego.Argument ten jest ignorowany.

• errtext
  Opis błędu rozszerzona procedura składowana jest errornum.

• errtextlen
  Długość ciąg błąd rozszerzona procedura składowana jest errtext.

• oserrtext
  Opis błędu systemu operacyjnego jest oserrnum.Argument ten jest ignorowany.

• oserrtextlen
  Długość ciąg błąd systemu operacyjnego jest oserrtext.

Zwraca

POMYŚLNIE lub nie powiedzie się.

Uwagi

The srv_message_handler function enables an extended stored procedure to integrate with the centralized error logging and reporting features of SQL Server.SQL Server alerts can be established for events from extended stored procedures, and SQL Server Agent will monitor for these alert conditions.

Komunikat o błędzie jest dłuższy, jest obcinana do 412 bajtów.

Uwaga dotycząca zabezpieczeń
Należy dokładnie przejrzeć kod źródłowy rozszerzonych procedur przechowywanych oraz przetestować skompilowane biblioteki DLL przed zainstalowaniem ich na serwerze produkcyjnym.Informacje o przegląd zabezpieczeń i testowania Zobacz to witryna sieci Web Microsoft.