srv_message_handler (rozszerzona procedura składowana API)

Important Note:
This feature will be removed in a future version of Microsoft SQL Server. Do not use this feature in new development work, and modify applications that currently use this feature as soon as possible. Zamiast korzystać z integracja środowiska CLR.

Wymaga zainstalowanego programu obsługi wiadomości rozszerzona procedura składowana interfejsu API.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.

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źnikiem struktury SRV_PROC, która jest dojście do połączenia określonego klient.The srvproc parameter contains information that is used to manage communication and data between the application and the klient.

• errornum
  Błąd numer jest określony przez rozszerzona procedura składowana.Ta liczba musi być z zakresu od 50 001 do 2 147 483 647.

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

• state
  Czy SQL Server wartość stanu błędu.

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

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

• errtextlen
  Jest to ciąg błędu rozszerzona procedura składowana errtext.

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

• oserrtextlen
  Jest to ciąg błędu systemu operacyjnego oserrtext.

Zwraca wartość

Powiodła się lub zakończyć się NIEPOWODZENIEM.

Remarks

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.

Security Note:
Należy dokładnie przejrzeć kod źródłowy rozszerzonych procedur przechowywanych oraz przetestować skompilowane biblioteki DLL przed zainstalowaniem ich na serwerze produkcyjnym.Aby uzyskać informacje dotyczące zabezpieczeń Przegląd i testowania zobacz temat to Witryny firmy Microsoft w sieci Web.