srv_pfield (API de procedimiento almacenado extendido)

Importante
Esta característica se quitará en una versión futura de Microsoft SQL Server. No utilice esta característica en nuevos trabajos de desarrollo y modifique lo antes posible las aplicaciones que actualmente la utilizan. En su lugar, utilice la integración 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	Un marcador 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	Un marcador. 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 Net-Library que se utiliza en 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 utilizar este identificador como un 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 devuelve el cliente, srvproc procede de DB-Library o de un cliente 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.

Devuelve

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.

Nota de seguridad
Debe revisar cuidadosamente 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 obtener información acerca de la revisión y pruebas de seguridad, vea el centro para programadores de seguridad.