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

Wysyła wiadomość do klient.

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źnikiem struktury SRV_PROC, która jest dojście do połączenia określonego klient (w tym przypadek uchwycie, który odebrał żądanie języka).Struktura zawiera informacje, które biblioteki API procedura przechowywana Extended używane do zarządzania komunikacji i danych między aplikacją a klient.

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

• msgnum
  Jest to numer komunikatu 4-bajtowego.

• class
  Określa wagę błędu.Ważności mniejsze lub równe 10 jest uważany za komunikat informacyjny.

• state
  Zawiera numer stanu błędu dla bieżącej wiadomości.numer stanu błędu zawiera informacje dotyczące kontekstu błędu.Stan prawidłowe numery są z zakresu od 0 do 255.

• rpcname
  Jest obecnie nieobsługiwany.

• rpcnamelen
  Jest obecnie nieobsługiwany.

• linenum
  Jest to numer wiersza w polecenia języka partia gdy stosuje się wiadomości.Rozpocznij numery wiersza od 1.Jeśli linenum nie ma zastosowania do wiadomości, zestaw na 0.

• message
  Jest wskaźnikiem ciąg znaków, które zostanie wysłane do klient.

• msglen
  Określa długość, w bajtach message. Jeśli message jest zakończony zerem, ustawianie msglen Aby SRV_NULLTERM.

Zwraca wartość

SUKCESU lub nie powiodło się

Remarks

Ta funkcja wysyła błędów i komunikaty informacyjne dla klient.Jest on nazywany jeden raz dla każdej wiadomości do wysłania.

Wiadomości mogą być wysyłane do klient przy użyciu srv_sendmsg w dowolnej kolejności, przed lub po wszystkich wierszy (jeśli istnieje), które zostały wysłane z srv_sendrow.Wszystkie wiadomości, muszą być wysyłane do klient przed stanu ukończenia jest wysyłany z srv_senddone.

Aby wysyłać wiadomości w trybie Unicode, należy użyć srv_wsendmsg zamiast srv_sendmsg.

Aby uzyskać więcej informacji, zobacz Server Pages kodu i danych Unicode.

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.