Compartir a través de


srv_pfield (API de procedimiento almacenado extendido)

Se aplica a: SQL Server

Importante

Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. En su lugar, use la integración de CLR.

Devuelve información acerca de una conexión de base de datos.

Sintaxis

  
DBCHAR * srv_pfield (  
SRV_PROC *  
srvproc  
,  
int   
field  
,  
int *  
len  
);  

Argumentos

srvproc
Puntero que identifica una conexión a la base de datos.

field
Especifica los datos que se van a devolver en la conexión.

Valor Devuelve
SRV_APPLNAME El nombre de aplicación proporcionado por el cliente cuando estableció la conexión.
SRV_BCPFLAG Una marca que es TRUE si el cliente está preparando una operación de copia masiva; de lo contrario, FALSE.
SRV_CLIB El nombre de la biblioteca que permite al cliente hablar con un servidor.
SRV_CPID El identificador de proceso de cliente en el equipo de origen del cliente.
SRV_HOST El nombre del equipo del cliente proporcionado por el cliente cuando estableció la conexión.
SRV_LIBVERS La versión de la biblioteca del cliente.
SRV_LSECURE Una marca. TRUE si la conexión utilizó seguridad integrada para iniciar sesión.
SRV_NETWORK_MODULE El nombre de la DLL de Net-Library que utiliza la conexión.
SRV_NETWORK_VERSION La versión de la DLL de Net-Library que utiliza la conexión.
SRV_NETWORK_CONNECTION La cadena de conexión pasada a la DLL de la biblioteca de red usada para la conexión srvproc actual.
SRV_PIPEHANDLE Una cadena que contiene el identificador de canalización de un cliente conectado o NULL si el cliente está conectado en una red que no utiliza canalizaciones con nombre. Para usar este identificador como identificador de canalización válido con Microsoft Windows, convierta esta cadena en un entero.
SRV_RMTSERVER El servidor desde el que inicia sesión el proceso de cliente. Si el inicio de sesión se realiza desde un cliente, este valor es una cadena vacía.
SRV_ROWSENT El número de filas ya enviado por srvproc para el conjunto actual de resultados.
SRV_SPID El identificador de subproceso de servidor de srvproc. En los procedimientos almacenados extendidos, este valor es igual que la columna kpid de sys.sysprocesses y puede cambiar con el tiempo.
SRV_SPROC_CODEPAGE Página de códigos que utiliza el servidor para interpretar datos multibyte.
SRV_STATUS El estado actual de srvproc: en ejecución o cerrado.
SRV_TYPE El tipo de conexión de srvproc. Si se devuelve el servidor, srvproc procede de una instancia de SQL Server. Si se ha devuelto el cliente, srvproc procede de un cliente DB-Library u ODBC.
SRV_USER El nombre del usuario de la conexión.

len
Es un puntero a una variable int que contiene la longitud del valor field devuelto. Si len es NULL, no se devuelve la longitud de la cadena.

Devoluciones

Un puntero a una cadena terminada en NULL que contiene el valor actual del campo especificado en la estructura de SRV_PROC. Si el campo está vacío, se devuelve un puntero válido a una cadena vacía y len contiene 0. Si el campo es desconocido, se devuelve NULL y len contiene el valor -1.

Importante

Debe revisar minuciosamente el código fuente de los procedimientos almacenados extendidos y debe probar las DLL compiladas antes de instalarlas en el servidor de producción. Para más información sobre la revisión y las pruebas de seguridad, vea Security Developer Center.