srv_rpcname (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 componente nombre de procedimiento del procedimiento almacenado remoto actual.

Sintaxis

DBCHAR * srv_rpcname (
SRV_PROC *
srvproc
,
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ó el 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.

• len
  Es un puntero a una variable entera que recibe la longitud del nombre de la base de datos. Si len es NULL, no se devuelve la longitud del nombre del procedimiento almacenado remoto.

Devuelve

Un puntero DBCHAR a la cadena terminada en NULL para el componente nombre de procedimiento almacenado remoto del procedimiento almacenado remoto actual. Si no hay ningún procedimiento almacenado remoto actual, se devuelve NULL y len se establece en -1.

Notas

Esta función sólo devuelve el nombre del procedimiento almacenado remoto. No incluye los especificadores opcionales propietario, nombre de la base de datos y número de procedimiento almacenado remoto.

Puesto que es válido llamar a srv_rpcname cuando no es un procedimiento almacenado remoto (no se produce ningún error informativo), esta función proporciona un método para determinar si existe un procedimiento almacenado remoto.

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.