Udostępnij za pośrednictwem

  • Artykuł

srv_setcollen (rozszerzona procedura składowana API)

Important noteImportant 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.

Określa bieżącą długość danych (w bajtach) kolumn o zmiennej długości lub kolumnie, w której są dopuszczane wartości NULL.


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

Argumenty

  • srvproc
    Jest wskaźnikiem struktury SRV_PROC, która jest dojście do połączenia określonego klient.Struktura zawiera informacje o bibliotece Extended API procedura przechowywana używane do zarządzania komunikacji i danych między aplikacją a klient.

  • column
    Wskazuje numer kolumna, dla których określonego długość danych.Kolumny są ponumerowane i zaczynają się od liczby 1.

  • len
    Wskazuje długość danych kolumna, w bajtach.Długość 0 oznacza, że wartość danych kolumna jest null.

Zwraca wartość

Powiodła się lub zakończyć się NIEPOWODZENIEM.

Remarks

Każda kolumna w wierszu, najpierw musi być zdefiniowana z srv_describe.Długość danych kolumna jest zestaw przez ostatnie wywołanie srv_describe or srv_zestawcollen.Jeśli zmienią się dane o zmiennej długości (dane zakończonym znakiem null) w wierszu, a srv_zestawcollen musi być używane do zestaw go do nowej długości przed wywołaniem srv_sendrow.W wypadku kolumna, która zezwala na wartości null srv_describe musi mieć została wywołana z desttype Ustaw typ danych, który zezwala na wartości null (takich jak SRVINTN) i danych null jest określony przez wywołanie srv_setcollen with len należy ustawić na 0. Danych o długości zerowej nie można określić przy użyciu API procedura przechowywana Extended.

Należy zauważyć, że jeśli typ danych kolumna o zmiennej długości, len nie jest zaznaczone. Ta funkcja zwraca zakończą się NIEPOWODZENIEM, jeśli dla kolumna o stałej długości.

Security noteSecurity 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.