srv_paramname (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 el nombre de un parámetro de llamada a un procedimiento almacenado remoto.

Sintaxis

DBCHAR * srv_paramname (
SRV_PROC * srvproc,intn, int *len );

Argumentos

• srvproc
  Es un puntero a la estructura SRV_PROC, que es el identificador de una conexión de cliente determinada (en este caso, el identificador que recibió la llamada al procedimiento almacenado remoto). La estructura contiene información que la biblioteca de API Procedimiento almacenado extendido utiliza para administrar la comunicación y los datos entre la aplicación y el cliente.

• n
  Indica el número del parámetro. El primer parámetro es 1.

• len
  Proporciona un puntero a una variable int que contiene la longitud (en bytes) del nombre de parámetro. Si len es NULL, no se devuelve la longitud del nombre de parámetro del procedimiento almacenado remoto.

Devuelve

Un puntero a una cadena de caracteres terminada en NULL que contiene el nombre del parámetro. La longitud del nombre de parámetro se almacena en len. Si no hay ningún parámetro n-ésimo ni ningún procedimiento almacenado remoto, devuelve NULL, len se establece en -1 y se envía un mensaje de error informativo. Si el nombre de parámetro es NULL, len se establece en 0 y se devuelve una cadena vacía terminada en NULL.

Notas

Esta función obtiene el nombre de un parámetro de llamada a un procedimiento almacenado remoto. Cuando se utilizan parámetros en una llamada a un procedimiento almacenado remoto, estos pueden pasarse por nombre o por posición (sin nombre). Se producirá un error en la llamada al procedimiento almacenado remoto si algunos parámetros se pasan por nombre y otros por posición. Sigue llamándose al controlador SRV_RPC, pero parece como si no hubiera ningún parámetro y srv_rpcparams devuelve 0.

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 este sitio web de Microsoft.

Vea también

Referencia

srv_rpcparams (API de procedimiento almacenado extendido)