srv_setcollen (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 longitud actual de los datos en bytes de una columna de longitud variable o de una columna que permite valores NULL.

Sintaxis

  
int srv_setcollen (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
int  
len   
);  

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 especifica la longitud de datos. Las columnas se numeran comenzando por 1.

len
Indica la longitud, en bytes, de los datos de la columna. Una longitud de 0 indica que el valor de datos de la columna es NULL.

Devoluciones

SUCCEED o FAIL.

Comentarios

Cada columna de la fila se debe definir antes con srv_describe. La longitud de datos de columna se establece mediante la última llamada a srv_describe o srv_setcollen. Si en una fila cambian los datos de longitud variable (datos terminados en NULL), se debe usar srv_setcollen para establecerlos en la nueva longitud antes de llamar a srv_sendrow. En una columna que permite valores NULL, es necesario llamar previamente a srv_describe con desttype establecido en un tipo de datos que permita valores NULL (como SRVINTN) y especificar datos NULL mediante una llamada a srv_setcollen con len establecido en 0. Los datos de longitud cero no se pueden especificar mediante la API Procedimiento almacenado extendido.

Tenga en cuenta que si el tipo de datos de la columna es de longitud variable, no se comprueba len. Esta función devuelve FAIL si se llama en una columna de longitud fija.

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)