srv_pfield (rozszerzony interfejs API procedury składowanej)
Dotyczy:
programu SQL Server
Ważny
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 należy użyć integracji środowiska CLR.
Zwraca informacje o połączeniu z bazą danych.
Składnia
DBCHAR * srv_pfield (
SRV_PROC *
srvproc
,
int
field
,
int *
len
);
Argumenty
Wskaźnik identyfikujący połączenie z bazą danych.
pola
Określa dane dotyczące połączenia, które ma być zwracane.
| Wartość | Zwraca |
|---|---|
| SRV_APPLNAME | Nazwa aplikacji podana przez klienta podczas nawiązywania połączenia. |
| SRV_BCPFLAG | Flaga, która ma wartość TRUE, jeśli klient przygotowuje się do operacji kopiowania zbiorczego; w przeciwnym razie, FAŁSZ. |
| SRV_CLIB | Nazwa biblioteki, która umożliwia klientowi rozmowę z serwerem. |
| SRV_CPID | Identyfikator procesu klienta na komputerze źródłowym klienta. |
| SRV_HOST | Nazwa maszyny klienta dostarczonej przez klienta podczas nawiązywania połączenia. |
| SRV_LIBVERS | Wersja biblioteki klienta. |
| SRV_LSECURE | Flaga. Wartość TRUE, jeśli połączenie używało zintegrowanych zabezpieczeń do logowania. |
| SRV_NETWORK_MODULE | Nazwa biblioteki DLL Net-Library używanej przez połączenie. |
| SRV_NETWORK_VERSION | Wersja biblioteki DLL Net-Library używana przez połączenie. |
| SRV_NETWORK_CONNECTION | Parametry połączenia przekazane do biblioteki DLL Net-Library używanej dla bieżącego połączenia srvproc. |
| SRV_PIPEHANDLE | Ciąg zawierający uchwyt potoku połączonego klienta lub wartość NULL, jeśli klient jest połączony w sieci, która nie używa nazwanych potoków. Aby użyć tego uchwytu jako prawidłowego uchwytu potoku w systemie Microsoft Windows, przekonwertuj ten ciąg na liczbę całkowitą. |
| SRV_RMTSERVER | Serwer, z którego jest zalogowany proces klienta. Jeśli identyfikator logowania pochodzi z klienta, ta wartość jest pustym ciągiem. |
| SRV_ROWSENT | Liczba wierszy już wysłanych przez srvproc dla bieżącego zestawu wyników. |
| SRV_SPID | Identyfikator wątku serwera srvproc. W przypadku rozszerzonych procedur składowanych ta wartość jest taka sama jak kolumna kpidsys.sysprocessesi może się zmieniać wraz z upływem czasu. |
| SRV_SPROC_CODEPAGE | Strona kodowa używana przez serwer do interpretowania danych wielobajtowych. |
| SRV_STATUS | Bieżący stan srvproc: uruchomione lub zamknięte |
| SRV_TYPE | Typ połączenia srvproc. Jeśli serwer zostanie zwrócony, srvproc pochodzi z wystąpienia programu SQL Server. Jeśli klient zostanie zwrócony, srvproc pochodzi z klienta DB-Library lub ODBC. |
| SRV_USER | Nazwa użytkownika połączenia. |
len
Jest wskaźnikiem do zmiennej int, która zawiera długość zwracanego pola . Jeśli len ma wartość NULL, długość ciągu nie jest zwracana.
Zwraca
Wskaźnik do ciągu zakończonego wartością null zawierającego bieżącą wartość określonego pola w strukturze SRV_PROC. Jeśli pole jest puste, zwracany jest prawidłowy wskaźnik pustego ciągu, a len zawiera wartość 0. Jeśli pole jest nieznane, zwracana jest wartość NULL, a len zawiera wartość -1.
Ważny
Przed zainstalowaniem ich na serwerze produkcyjnym należy dokładnie przejrzeć kod źródłowy rozszerzonych procedur składowanych i przetestować skompilowane biblioteki DLL. Aby uzyskać informacje na temat przeglądu zabezpieczeń i testowania, zobacz Security Developer Center.