Udostępnij przez

srv_describe (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 nazwę kolumna i urządzenie źródłowe i obiekt docelowy typy danych dla danej kolumna w wierszu.


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źnikiem struktury SRV_PROC, która jest dojście do połączenia określonego klienta (w tym przypadek klient wysyła wiersz).Struktura zawiera wszystkie informacje, które biblioteki API procedura przechowywana Extended używane do zarządzania komunikacji i danych między aplikacją a klient.

  • colnumber
    Jest obecnie nieobsługiwany.Kolumny muszą być opisane w kolejności.Wszystkie kolumny muszą być opisane przed srv_sendrow nosi nazwę.

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

  • namelen
    Określa długość, w bajtach column_name. Jeśli namelen następnie jest SRV_NULLTERM, column_name musi być zakończona znakiem null.

  • desttype
    Określa typ danych kolumna wiersza docelowego.Jest to typ danych wysłanych do klient.Typem danych musi być określona, nawet jeśli dane są wartości NULL, aby uzyskać więcej informacji, zobacz Typy danych (rozszerzona procedura składowana API).

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

  • srctype
    Określa typ danych urządzenie źródłowe danych.

  • srclen
    Określa długość, w bajtach, urządzenie źródłowe danych.Wartość ta jest ignorowana dla typów danych o stałej długości.

  • srcdata
    Zawiera adres urządzenie źródłowe danych dla określonej kolumna.Kiedy srv_sendrow jest wywoływana, szuka danych dla colnumber na srcdata. W związku z tym go powinno nie można zwolnić przed wywołaniem srv_sendrow.Adresu urządzenie źródłowe danych mogą być zmieniane między wywołaniami srv_sendrow by using srv_setcoldata.Pamięć przydzielona dla srcdata nie należy zostały zwolnione, dopóki dane kolumna są zastępowane przez inne wywołanie do srv_setcoldata, or until srv_senddone nosi nazwę.

    Jeśli desttype jest SRVDECIMAL lub SRVNUMERIC, srcdata Parametr musi być już wskaźnik do struktury DBNUMERIC lub DBDECIMAL w polach precyzji i skali struktury zestaw na odpowiednie wartości. DEFAULTPRECISION służy do określenia dokładności domyślne i DEFAULTSCALE, aby określić skalę domyślne.

Zwraca wartość

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

Remarks

The srv_describe funkcja must be called once for each kolumna in the row before the first call to srv_sendrow.Kolumny wiersza można opisać w dowolnej kolejności.

Aby zmienić położenie i długość urządzenie źródłowe dane w wierszach kolumna przed zestaw wyników pełną został wysłany, należy użyć srv_setcoldata and srv_setcollen, odpowiednio.

Aby uzyskać opis typów danych i konwersje typów danych API procedura magazynu rozszerzonego ZobaczTypy danych (rozszerzona procedura składowana API).

Jeśli nazwa kolumna w aplikacji jest w trybie Unicode, należy przekonwertować go strona kodowa wielobajtowych serwera przed telefonicznej srv_describe.Aby uzyskać więcej informacji zobaczServer Pages kodu i danych Unicode.

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.
  • Last updated on