srv_setcoldata (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.

Especifica la dirección actual para los datos de una columna.

Sintaxis

  
int srv_setcoldata (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
void *  
data   
);  

Argumentos

srvproc
Es un puntero a la estructura SRV_PROC que es el identificador de una conexión cliente determinada. La estructura contiene información que la biblioteca de API de procedimiento almacenado extendido usa para administrar la comunicación y los datos entre la aplicación y el cliente.

column
Indica el número de la columna para la que se especificó la dirección. Las columnas se numeran comenzando por 1.

data
Es un puntero para los datos de una columna. La memoria asignada para data no se debería liberar hasta que los datos de la columna se sustituyan por otra llamada a srv_setcoldata, o hasta que se realice una llamada a srv_senddone .

Devoluciones

SUCCEED o FAIL.

Comentarios

Cada columna de la fila se debe definir antes con srv_describe. Las direcciones de datos de columna se establecen inicialmente con srv_describe. Si la dirección de datos de columna cambia, se debe llamar a srv_setcoldata para especificar la nueva dirección de los datos y se debe llamar a srv_setcoldata por separado para cada columna modificada.

Los datos nulos se representan estableciendo la longitud de la columna en 0 con srv_setcollen. Entonces, se omite la dirección de datos.

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 obtener información acerca de la revisión y pruebas de seguridad, vea este sitio web de Microsoft.

Consulte también

srv_describe (API de procedimiento almacenado extendido)