Udostępnij za pośrednictwem


srv_describe (Extended przechowywane procedury API)

Ważna informacjaWaż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.

Określa nazwę kolumna i źródło i obiekt docelowy typy danych dla okreolonej kolumna w wierszu.

Składnia


int srv_describe (
SRV_PROC *
srvproc
,
int
colnumber
,
DBCHAR *
column_name
,
int
namelen
,
DBINT
desttype
,
DBINT
destlen
,
DBINT
srctype
,
DBINT
srclen
,
void *
srcdata
);

Argumenty

  • srvproc
    Jest wskaźnik do struktury SRV_PROC dojście do połączenia określonego klienta (w tym przypadek klient wysyła wiersz).Struktura zawiera wszystkie informacje biblioteki API procedury przechowywane Extended używa do zarządzania komunikacji i danych między aplikacją i klient.

  • colnumber
    Nie jest obecnie obsługiwany.Kolumny muszą być opisane w kolejności.Wszystkie kolumny muszą być opisane przed srv_sendrow jest wywoływana.

  • column_name
    Określa nazwę kolumna, do której należy dane.Ten parametr może być NULL, ponieważ kolumna nie musi mieć nazwę.

  • namelen
    Określa długość w bajtach, column_name.Jeśli namelen jest SRV_nulltermin, a następnie column_name musi być null-zakończone.

  • desttype
    Określa typ danych obiekt docelowy wiersza kolumna.Jest to typ danych wysłanych do klient.Typ danych musi być określony, nawet jeśli dane wartości NULL, aby uzyskać więcej informacji, zobacz Typy danych (rozszerzona procedura przechowywana API).

  • destlen
    Określa długość bajtów danych wysłanych do klient.Dla typów danych o stałej długości, które nie zezwalaj na wartooci null destlen jest ignorowana.Typy danych o zmiennej długości i typy danych o stałej długości, dopuszczającej wartości null destlen Określa maksymalną długość danych obiekt docelowy może być.

  • srctype
    Określa typ danych źródło danych.

  • srclen
    Określa długość w bajtach, źródło danych.Ta wartość jest ignorowana dla typów danych o stałej długości.

  • srcdata
    Zawiera adres źródło danych dla określonej kolumna.Gdy srv_sendrow jest wywoływana, szuka danych dla colnumber na srcdata.Dlatego go powinna nie zwolniona przed wywołaniem srv_sendrow.Adres źródło danych można zmieniać między wywołaniami do srv_sendrow za pomocą srv_setcoldata.Pamięć przydzielona dla srcdata nie powinny zwolniona dopóki dane kolumna zastępuje inne wywołanie srv_setcoldata, lub aż srv_senddone jest wywoływana.

    Jeśli desttype SRVDECIMAL lub SRVNUMERIC, srcdata parametr musi być wskaźnik do DBNUMERIC lub DBDECIMAL struktury pól precyzji i skali struktury już zestaw wartości chcesz.DEFAULTPRECISION można używać do określania Domyślna precyzja i DEFAULTSCALE, aby określić Skala domyślna.

Zwraca

Numer kolumna opisane.Pierwsza kolumna jest kolumna 1.Jeśli wystąpi błąd, zwraca wartość 0.

Uwagi

Srv_describe funkcja musi być wywołana raz dla każdej kolumna w wierszu przed pierwszym wywołaniem srv_sendrow.Kolumny wiersza można opisać w dowolnej kolejności.

Aby zmienić położenie i długość źródło dane w wierszach kolumna przed wysłał zestaw wyników pełną pomocą srv_setcoldata i srv_setcollen, odpowiednio.

Opis typów danych i konwersje typów danych rozszerzonych API procedury magazynu, zobaczTypy danych (rozszerzona procedura przechowywana API).

Jeśli nazwa kolumna w aplikacji jest w formacie Unicode, należy przekonwertować go na strona kodowa wielobajtowych serwera przed wywoływaniem srv_describe.Aby uzyskać więcej informacji, zobacz Dane Unicode i stron kodowych serwera.

Uwaga dotycząca zabezpieczeń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.