Share via


SQLProcedureColumns

SQLProcedureColumns devuelve una fila que notifica los atributos del valor devuelto de todos los procedimientos almacenados de SQL Server.

SQLProcedureColumns devuelve SQL_SUCCESS tanto si existen valores o no de los parámetros CatalogName, SchemaName, ColumnName o ProcName. SQLFetch devuelve SQL_NO_DATA si se usan valores no válidos en estos parámetros.

SQLProcedureColumns se puede ejecutar en un cursor de servidor estático. Un intento de ejecutar SQLProcedureColumns en un cursor actualizable (dinámico o controlado por conjunto de claves) devolverá SQL_SUCCESS_WITH_INFO, lo que indica que se ha cambiado el tipo de cursor.

En la tabla siguiente se muestran las columnas devueltas por el conjunto de resultados y cómo se han extendido para administrar los tipos de datos xml y udt a través del controlador ODBC de SQL Server Native Client:

Nombre de la columna

Descripción

SS_UDT_CATALOG_NAME

Devuelve el nombre del catálogo que contiene el UDT (tipo definido por el usuario).

SS_UDT_SCHEMA_NAME

Devuelve el nombre del esquema que contiene el UDT.

SS_UDT_ASSEMBLY_TYPE_NAME

Devuelve el nombre completo de ensamblado del UDT.

SS_XML_SCHEMACOLLECTION_CATALOG_NAME

Devuelve el nombre del catálogo donde se define un nombre de colección de esquemas XML. Si no se encuentra el nombre de catálogo, esta variable contiene una cadena vacía.

SS_XML_SCHEMACOLLECTION_SCHEMA_NAME

Devuelve el nombre del esquema donde se define un nombre de colección de esquemas XML. Si no se encuentra el nombre de esquema, esta variable contiene una cadena vacía.

SS_XML_SCHEMACOLLECTION_NAME

Devuelve el nombre de una colección de esquemas XML. Si no se encuentra el nombre, esta variable contiene una cadena vacía.

SQLProcedureColumns y los parámetros con valores de tabla

SQLProcedureColumns administra los parámetros con valores de tabla de una manera similar a los tipos definidos por el usuario CLR. En las filas devueltas para los parámetros con valores de tabla, las columnas tienen los valores siguientes:

Nombre de columna

Descripción/valor

DATA_TYPE

SQL_SS_TABLE

TYPE_NAME

El nombre del tipo de tabla para el parámetro con valores de tabla.

COLUMN_SIZE

NULL

BUFFER_LENGTH

0

DECIMAL_DIGITS

El número de columnas del parámetro con valores de tabla.

NUM_PREC_RADIX

NULL

NULLABLE

SQL_NULLABLE

REMARKS

NULL

COLUMN_DEF

NULL. Los tipos de tabla puede que no tengan valores predeterminados.

SQL_DATA_TYPE

SQL_SS_TABLE

SQL_DATEIME_SUB

NULL

CHAR_OCTET_LENGTH

NULL

IS_NULLABLE

"YES"

SS_TYPE_CATALOG_NAME

Devuelve el nombre del catálogo que contiene la tabla o el tipo definido por el usuario CLR.

SS_TYPE_SCHEMA_NAME

Devuelve el nombre del esquema que contiene la tabla o el tipo definido por el usuario CLR.

Las columnas SS_TYPE_CATALOG_NAME y SS_TYPE_SCHEMA_NAME están disponibles en SQL Server 2008 y versiones posteriores para devolver el catálogo y el esquema, respectivamente, de los parámetros con valores de tabla. Estas columnas se rellenan para los parámetros con valores de tabla y también para los parámetros de tipos definidos por el usuario CLR. (Esta función adicional no afecta al esquema ni a las columnas de catálogo existentes para los parámetros de tipos definidos por el usuario CLR. También se rellenan para mantener la compatibilidad con versiones anteriores).

De acuerdo con la especificación de ODBC, SS_TYPE_CATALOG_NAME y SS_TYPE_SCHEMA_NAME aparecen antes de todas las columnas específicas del controlador agregadas en versiones anteriores de SQL Servery después de todas las columnas asignadas por el propio ODBC.

Para obtener más información acerca de los parámetros con valores de tabla, vea Parámetros con valores de tabla (ODBC).

SQLProcedureColumns admite las características mejoradas de fecha y hora

Para obtener los valores devueltos para los tipos de fecha y hora, vea Metadatos de catálogo.

Para obtener información general, vea Mejoras en los tipos de datos de fecha y hora (ODBC).

SQLProcedureColumns admite UDT CLR grandes

SQLProcedureColumns admite tipos definidos por el usuario (UDT) CLR grandes. Para obtener más información, vea Tipos CLR grandes definidos por el usuario (ODBC).

Vea también

Conceptos

Detalles de implementación de la API de ODBC

Otros recursos

Función SQLProcedureColumns