srv_sendmsg (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.

Wysyła wiadomość do klient.

Składnia

int srv_sendmsg (
SRV_PROC *
srvproc
,
int
msgtype
,
DBINT
msgnum
,
DBTINYINT
class
, 
DBTINYINT
state
,
DBCHAR *
rpcname
,
int 
rpcnamelen
,
DBUSMALLINT
linenum
,
DBCHAR *
message
,
int
msglen 
);

Argumenty

• srvproc
  Jest wskaźnik do struktury SRV_PROC dojście do połączenia określonego klient (w tym przypadek uchwyt, który odebrał żądanie języka).Struktura zawiera informacje biblioteki API procedury przechowywane Extended używane do zarządzania komunikacji i danych między aplikacji i klient.

• msgtype
  Jest SRV_MSG_INFO lub SRV_MSG_ERROR, w zależności od tego, czy serwer wysyła komunikat informacyjny lub błąd.

• msgnum
  4-Bajtowa jest numer komunikatu.

• class
  Określa wagę błędu.Wskaźnik ważności jest mniejsza lub równa 10 uważane za komunikat informacyjny.

• state
  Zawiera numer stanu błędu dla bieżącego komunikatu.numer stanu błędu zawiera informacje dotyczące kontekstu błędu.Nieprawidłowy stan numery są od 0 do 255.

• rpcname
  Nie jest obecnie obsługiwany.

• rpcnamelen
  Nie jest obecnie obsługiwany.

• linenum
  To numer wiersza w partia polecenia języka, gdzie dotyczy komunikat.Start numery linii 1.Jeśli linenum nie stosuje się do wiadomości, zestaw 0.

• message
  Jest wskaźnik do ciąg znaków ma być wysłany do klient.

• msglen
  Określa długość w bajtach, message.Jeśli message jest zakończony znakiem null, zestaw msglen SRV_NULLTERM.

Zwraca

SUCCEED lub błędów

Uwagi

Ta funkcja wysyła błędów i komunikatów informacyjnych do klient.Jest ona wywoływana raz dla każdej wiadomości do wysłania.

Wiadomości mogą być wysyłane do klient z srv_sendmsg w dowolnej kolejności, przed lub po wysłaniu wszystkich wierszy (jeżeli występują) z srv_sendrow.Wszystkie wiadomości, muszą być wysyłane do klient przed stanu ukończenia jest wysyłany z srv_senddone.

Służy do wysyłania wiadomości w formacie Unicode, srv_wsendmsg zamiast srv_sendmsg.

Aby uzyskać więcej informacji, zobacz Dane Unicode i stron kodowych serwera.

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.