Partager via

SQLProcedureColumns

SQLProcedureColumns retourne une ligne signalant les attributs de valeur de retour de toutes les procédures stockées SQL Server.

SQLProcedureColumnsretourne SQL_SUCCESS si des valeurs existent ou non pour les paramètres CatalogName, SchemaName, ProcName ou ColumnName. SQLFetch retourne SQL_NO_DATA lorsque des valeurs non valides sont utilisées dans ces paramètres.

SQLProcedureColumns peut être exécuté sur un curseur de serveur statique. Une tentative d’exécution SQLProcedureColumns sur un curseur pouvant être mis à jour (dynamique ou jeu de clés) retourne SQL_SUCCESS_WITH_INFO indiquant que le type de curseur a été modifié.

Le tableau suivant répertorie les colonnes retournées par le jeu de résultats et la façon dont elles ont été étendues pour gérer les types de données udt et xml via le pilote ODBC SQL Server Native Client :

Nom de colonne Descriptif
SS_UDT_CATALOG_NAME Retourne le nom du catalogue contenant le type défini par l'utilisateur (UDT).
SS_UDT_SCHEMA_NAME Retourne le nom du schéma contenant l'UDT.
SS_UDT_ASSEMBLY_TYPE_NAME Retourne le nom qualifié de l'assembly du type défini par l'utilisateur (UDT).
SS_XML_SCHEMACOLLECTION_CATALOG_NAME Retourne le nom du catalogue dans lequel un nom de collection de schémas XML est défini. Si le nom du catalogue est introuvable, cette variable contient une chaîne vide.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME Retourne le nom du schéma dans lequel un nom de collection de schémas XML est défini. Si le nom du schéma est introuvable, cette variable contient une chaîne vide.
SS_XML_SCHEMACOLLECTION_NAME Retourne le nom d'une collection de schémas XML. Si le nom est introuvable, cette variable contient une chaîne vide.

SQLProcedureColumns et paramètres table

SQLProcedureColumns gère les paramètres table d’une manière similaire aux types CLR définis par l’utilisateur. Dans les lignes retournées pour les paramètres table, les colonnes ont les valeurs suivantes :

Nom de colonne Description/valeur
TYPE_DE_DONNÉES SQL_SS_TABLE
TYPE_NAME Nom du type de table pour le paramètre table.
COLUMN_SIZE ZÉRO
BUFFER_LENGTH 0
DECIMAL_DIGITS Nombre de colonnes du paramètre table.
NUM_PREC_RADIX ZÉRO
NULLABLE SQL_NULLABLE
Remarques ZÉRO
COLUMN_DEF ZÉRO. Les types table ne peuvent pas avoir de valeurs par défaut.
SQL_DATA_TYPE SQL_SS_TABLE
SQL_DATEIME_SUB ZÉRO
CHAR_OCTET_LENGTH ZÉRO
IS_NULLABLE « OUI »
SS_TYPE_CATALOG_NAME Retourne le nom du catalogue qui contient la table ou le type CLR défini par l'utilisateur.
SS_TYPE_SCHEMA_NAME Retourne le nom du schéma qui contient la table ou le type CLR défini par l'utilisateur.

Les colonnes SS_TYPE_CATALOG_NAME et SS_TYPE_SCHEMA_NAME sont disponibles dans SQL Server 2008 et versions ultérieures pour retourner le catalogue et le schéma, respectivement, pour les paramètres table. Ces colonnes sont remplies pour les paramètres table, et également pour les paramètres de type CLR défini par l'utilisateur. (Les colonnes de schéma et de catalogue existantes pour les paramètres de type défini par l’utilisateur CLR ne sont pas affectées par cette fonctionnalité supplémentaire. Elles sont également remplies pour maintenir la compatibilité descendante).

Conformément à la spécification ODBC, SS_TYPE_CATALOG_NAME et SS_TYPE_SCHEMA_NAME apparaissent avant que toutes les colonnes spécifiques au pilote soient ajoutées dans les versions précédentes de SQL Server, et après toutes les colonnes mandatées par ODBC lui-même.

Pour plus d’informations sur les paramètres table, consultez Paramètres table (ODBC) .

Prise en charge par SQLProcedureColumns des fonctionnalités de date et heure améliorées

Pour les valeurs retournées pour les types de date/heure, consultez Catalog Metadata.

Pour plus d’informations générales, consultez Améliorations de date et d’heure (ODBC).

Prise en charge par SQLProcedureColumns des grands types CLR définis par l'utilisateur

SQLProcedureColumns prend en charge les types clR définis par l’utilisateur (UDT). Pour plus d’informations, consultez Les types CLR définis par l’utilisateur (ODBC) volumineux.

Voir aussi

SQLProcedureColumns, fonction
Détails de l’implémentation d’API ODBC

  • Last updated on