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

Ustawia wartość zdalna procedura składowana zwracanych parametrów wywołania.Ta funkcja została zastąpiona przez srv_paramsetoutput funkcji.

Składnia

int srv_paramset (
SRV_PROC *
srvproc
,
int
n
, 
void *
data
,
int
len 
);

Argumenty

• srvproc
  Jest wskaźnik do struktury SRV_PROC dojście do połączenia określonego klient (w tym przypadek uchwytu, otrzymane zdalna procedura składowana wywołania).Struktura zawiera informacje biblioteki API procedury przechowywane Extended używa do zarządzania komunikacji i danych między aplikacją i klient.

• n
  Wskazuje numer parametru zestaw.Pierwszy parametr jest 1.

• data
  Jest wskaźnik do wartości danych do wysłania do klient jako parametr zwrotu zdalna procedura składowana.

• len
  Określa długość rzeczywiste dane zwracane.Jeśli typ danych parametru jest o stała długości i nie dopuszcza wartości null (na przykład srvbit lub srvint1), len jest ignorowana.

Zwraca

GDY wartość parametru został pomyślnie zestaw; w przeciwnym razie nie powiedzie się.Niepowodzenie jest zwracana, gdy brak bieżącej zdalna procedura składowana, gdy istnieje nie nth zdalna procedura składowana parametru, parametr jest zwracanych parametrów i gdy len argument jest prawnych.

If lenis 0, it returns NULL.Ustawienie len 0 jest to jedyny sposób, aby zwrócić NULL do klient.

This function returns the following values, if the parameter is one of Microsoft SQL Server 2005 data types.

Nowe typy danych	Zwraca długość danych
BITN	WARTOŚCI NULL:len = 0, dane = IG RET = 0 ZERO: Brak >= 255: Brak <255: Brak
BIGVARCHAR	WARTOŚCI NULL:len = 0, dane = IG RET = 1 ZERO:len = IG, dane = IG RET = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1
BIGCHAR	WARTOŚCI NULL:len = 0, dane = IG RET = 1 ZERO:len = IG, dane = IG RET = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1
BIGBINARY	WARTOŚCI NULL:len = 0, dane = IG RET = 1 ZERO:len = IG, dane = IG RET = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1
BIGVARBINARY	WARTOŚCI NULL:len = 0, dane = IG RET = 1 ZERO:len = IG, dane = IG RET = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1
NCHAR	WARTOŚCI NULL:len = 0, dane = IG RET = 1 ZERO:len = IG, dane = IG RET = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1
NVARCHAR	WARTOŚCI NULL:len = 0, dane = IG RET = 1 ZERO:len = IG, dane = IG RET = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1
NTEXT	WARTOŚCI NULL:len = IG, dane = IG RET = 0 ZERO:len = IG, dane = IG RET = 0 >=255:len = IG, data = IG, RET = 0 <255:len = IG, data = IG, RET = 0
RET = wartość zwracana srv_paramset
IG = wartość zostanie zignorowany.
prawidłowe = dowolny prawidłowy wskaźnik do danych

Uwagi

Parametry zawierają danych przesyłanych między klientami a aplikacji zdalnego procedur przechowywanych.Niektóre parametry można określić parametrów zwrotnych klient.Zwrotu parametry te mogą zawierać wartości, które przekazuje otwartych usług danych aplikacji serwera do klient.Przy użyciu parametrów zwracana jest analogiczne do przekazywania parametrów przez odwołanie.

Nie zestaw wartość zwracana dla parametru, który nie został wywołany jako parametr zwrotu.Można użyć srv_paramstatus do określenia, jaki parametr został wywołany.

Ta funkcja ustawia wartość zwracana dla parametru ale faktycznie wysyła wartość zwracaną do klient.Zwracają parametry, czy ich zwrotu wartości zostały ustawione z srv_paramset lub nie, są automatycznie wysyłane do klient po srv_senddone jest nazywany stanem flagi zestaw SRV_DONE_FINAL.

Po nawiązaniu połączenia zdalna procedura składowana z parametrami parametry można przekazać nazwę lub położenie (nienazwanych).Jeśli zdalna procedura składowana rozmowy z niektórych parametrów przekazanych przez nazwę i niektóre przekazywane według położenia, wystąpi błąd.Nadal nosi obsługi SRV_RPC, ale wydaje się, jak gdyby były bez parametrów i srv_rpcparams zwraca wartość 0.

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.

Zobacz także

Odwołanie

srv_paramsetoutput (Extended przechowywane procedury API)