srv_rpcname (API de procedimiento almacenado extendido)srv_rpcname (Extended Stored Procedure API)

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions)

Importante

Esta característica se quitará en una versión futura de Microsoft SQL Server.This feature will be removed in a future version of Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use la integración con CLR en su lugar.Use CLR integration instead.

Devuelve el componente nombre de procedimiento del procedimiento almacenado remoto actual.Returns the procedure name component for the current remote stored procedure.

SintaxisSyntax

  
DBCHAR * srv_rpcname (  
SRV_PROC *  
srvproc  
,  
int *  
len   
);  

ArgumentosArguments

srvprocsrvproc
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).Is a pointer to the SRV_PROC structure that is the handle for a particular client connection (in this case, the handle that received the remote stored procedure). 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.The structure contains information that the Extended Stored Procedure API library uses to manage communication and data between the application and the client.

terminadolen
Es un puntero a una variable entera que recibe la longitud del nombre de la base de datos.Is a pointer to an integer variable that receives the length of the database name. Si len es NULL, no se devuelve la longitud del nombre del procedimiento almacenado remoto.If len is NULL, the length of the remote stored procedure name is not returned.

DevuelveReturns

Un puntero DBCHAR a la cadena terminada en NULL para el componente nombre de procedimiento almacenado remoto del procedimiento almacenado remoto actual.A DBCHAR pointer to the null-terminated string for the remote stored procedure name component of the current remote stored procedure. Si no hay ningún procedimiento almacenado remoto actual, se devuelve NULL y len se establece en -1.If there is not a current remote stored procedure, NULL is returned and len is set to -1.

ObservacionesRemarks

Esta función solo devuelve el nombre del procedimiento almacenado remoto.This function returns only the name of the remote stored procedure. No incluye los especificadores opcionales propietario, nombre de la base de datos y número de procedimiento almacenado remoto.It does not include the optional specifiers for owner, database name, and remote stored procedure number.

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.Because it is valid to call srv_rpcname when there is not a remote stored procedure (no informational error occurs), this function provides a method for determining whether a remote stored procedure exists.

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.You should thoroughly review the source code of extended stored procedures, and you should test the compiled DLLs before you install them on a production server. Para obtener información acerca de la revisión y pruebas de seguridad, vea este sitio web de Microsoft.For information about security review and testing, see this Microsoft Web site.