srv_setcollen (API rozszerzonych procedur przechowywanych)

Dotyczy:SQL Server

Ważna

Ta funkcja zostanie usunięta w przyszłej wersji programu SQL Server. Unikaj używania tej funkcji w nowych pracach programistycznych i zaplanuj modyfikowanie aplikacji, które obecnie korzystają z tej funkcji. Zamiast tego użyj integracji CLR.

Określa aktualną długość danych w bajtach kolumny o zmiennej długości lub kolumny dopuszczającej wartości NULL.

Syntax

  
int srv_setcollen (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
int  
len   
);

Arguments

srvproc
Jest wskaźnikiem do struktury SRV_PROC, która jest uchwytem dla konkretnego połączenia klienta. Struktura zawiera informacje, które biblioteka API Extended Stored Procedure wykorzystuje do zarządzania komunikacją i danymi między aplikacją a klientem.

kolumna
Wskazuje numer kolumny, dla której określana jest długość danych. Kolumny są ponumerowane od 1.

len
Wskazuje długość danych kolumnowych w bajtach. Długość 0 oznacza, że wartość danych kolumny jest zerowa.

Zwroty

POWODZENIE lub NIEPOWODZENIE.

Remarks

Każdą kolumnę wiersza należy najpierw zdefiniować z srv_describe. Długość danych kolumny ustalana jest przez ostatnie wywołanie na srv_describe lub srv_setcollen. Jeśli dane o zmiennej długości (dane zakończone zerowo) zmieniają się dla wiersza, srv_setcollen musi zostać użyte do ustawienia ich na nową długość przed wywołaniem srv_sendrow. Dla kolumny dopuszczającej wartości zerowe srv_describe musi być wywołana z typem desttype ustawionym na typ danych dopuszczający nulls (jak SRVINTN), a dane null są określane przez wywołanie srv_setcollen z ustawionym len na 0. Dane o zerowej długości nie mogą być określone za pomocą API Extended Stored Procedure.

Należy zauważyć, że gdy typ danych kolumny ma zmienną długość, len nie jest sprawdzany. Funkcja ta zwraca FAIL, jeśli wywołana jest kolumna o stałej długości.

Ważna

Powinieneś dokładnie przejrzeć kod źródłowy rozszerzonych procedur przechowywanych i przetestować skompilowane pliki DLL przed instalacją ich na serwerze produkcyjnym. Informacje o przeglądzie i testowaniu bezpieczeństwa znajdziesz na tej stronie internetowej Microsoft.

Treści powiązane

  • Last updated on