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

Ustawia wartość zdalna procedura składowana wywołania zwrotnego parametru.Funkcja ta została zastąpiona srv_paramsetoutput funkcji.

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

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ł wywołanie procedura przechowywana zdalnego).Struktura zawiera informacje o bibliotece Extended API procedura przechowywana używane do zarządzania komunikacji i danych między aplikacją a klient.

• n
  Wskazuje liczbę parametr zestaw.Pierwszy parametr jest 1.

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

• len
  Określa długość rzeczywiste dane, które mają zostać zwrócone.Jeśli typ danych parametru jest o stała długości, a nie zezwala na wartości null (na przykład srvbit lub srvint1), len jest ignorowana.

Zwraca wartość

Kończą się pomyślnie, jeśli wartość parametru został pomyślnie zestaw; w przeciwnym wypadku nie powiedzie się.Niepowodzenie jest zwracana, gdy jest nie zdalnego bieżącej procedura przechowywana, gdy nie ma żadnych nth zdalnego przechowywane procedury parametr, gdy parametr nie jest zwracany parametru i len argument jest niedozwolona.

If lenis 0, it returns NULL.Ustawienie len 0 jest to jedyny sposób, aby zwrócić wartość NULL dla 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 WARTOŚĆ ZERO: NIE DOTYCZY >= 255: N/A <255: N/A
BIGVARCHAR	WARTOŚCI NULL:len = 0, dane = IG RET = 1 WARTOŚĆ 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 WARTOŚĆ 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 WARTOŚĆ 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 WARTOŚĆ 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 WARTOŚĆ 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 WARTOŚĆ 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 WARTOŚĆ ZERO:len = IG, dane = IG RET = 0 >=255:len = IG, data = IG, RET = 0 <255:len = IG, data = IG, RET = 0
POZOSTAW = wartość zwrotu srv_paramset
IG = wartość zostanie zignorowany.
prawidłowe = dowolny prawidłowy wskaźnik do danych

Remarks

Parametry zawierają dane przekazywane między klientami i aplikacji ze zdalnych procedur przechowywanych.Klient może określić pewne parametry jako parametry zwrotu.Zwrotu parametry te mogą zawierać wartości, które przekazuje Otwórz 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 , aby określić, jak parametr został wywołany.

Ta funkcja określa wartość zwracana dla parametru, ale nie faktycznie wysyła wartość zwracaną do klient.Wszystkie parametry, zwracają czy ich wartości zwracanej zostały ustawione z srv_paramset lub nie są automatycznie wysyłane do klient po srv_senddone nazywa się o stanie dla flagi jest ustawiona SRV_DONE_FINAL.

Gdy zdalna procedura składowana rozmowy z parametrami, parametry można przekazać według nazwy lub według pozycji (nienazwane).Jeżeli z niektórych parametrów przekazanych przez nazwę i niektóre przekazywane za pomocą pozycji wywołań zdalnych procedura przechowywana, wystąpi błąd.Obsługa SRV_RPC nadal ma nazwę, ale wydaje się, jak gdyby były bez parametrów i srv_rpcparams zwraca wartość 0.

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.

See Also

Reference

srv_paramsetoutput (Extended przechowywanych procedur API)