Valeurs d'initialisation d'en-tête de descripteur et de zone d'enregistrement (CLI)

En fonction des zones d'en-tête de descripteur que vous utilisez, vous pouvez avoir une zone déjà initialisée avec une valeur par défaut ou avoir une zone en lecture / écriture (R/W) ou en lecture seule (R).

Les tableaux suivants répertorient l'initialisation de chaque zone pour chaque type de descripteur, avec D indiquant que la zone est initialisée avec une valeur par défaut, et ND indiquant que la zone est initialisée sans valeur par défaut. Si un nombre est affiché, la valeur par défaut de la zone est ce nombre. Les tableaux indiquent également si une zone est en lecture / écriture (R/W) ou en lecture seule (R).

Tableau 1. Initialisation des zones d'en-tête
Zone d'en-tête de descripteur	Type	Accessible en lecture et en écriture (R/W) ou en lecture seule (R)	Valeur d'initialisation
SQL_DESC_ALLOC_TYPE	SQLSMALLINT	ARD: R APD: R IRD: R IPD: R	ARD: SQL_DESC_ALLOC_AUTO pour implicite ou SQL_DESC_ALLOC_USER pour explicite APD: SQL_DESC_ALLOC_AUTO pour implicite ou SQL_DESC_ALLOC_USER pour explicite IRD: SQL_DESC_ALLOC_AUTO IPD: SQL_DESC_ALLOC_AUTO
TAILLE DES_DESC_ARRAY_SQL	SQLUENTIER	ARD: R/W APD: R/W IRD: Inutilisé IPD: Inutilisé	ARD: ^a APD: ^a IRD: Inutilisé IPD: Inutilisé
SQL_DESC_ARRAY_STATUS_PTR	SQLUSMALLINT *	ARD: R/W APD: R/W IRD: R/W IPD: R/W	ARD: Ptr NULL APD: Ptr NULL IRD: Ptr NULL IPD: Ptr NULL
SQL_DESC_BIND_OFFSET_PTR	ENTIER SQL *	ARD: R/W APD: R/W IRD: Inutilisé IPD: Inutilisé	ARD: Ptr NULL APD: Ptr NULL IRD: Inutilisé IPD: Inutilisé
SQL_DESC_BIND_TYPE	SQLENTIER	ARD: R/W APD: R/W IRD: Inutilisé IPD: Inutilisé	ARD: SQL_BIND_BY_COLUMN APD: SQL_BIND_BY_COLUMN IRD: Inutilisé IPD: Inutilisé
NOM_DESC_SQL	SQLSMALLINT	ARD: R/W APD: R/W IRD: R IPD: R/W	ARD: 0 APD: 0 IRD: D IPD: 0
SQL_DESC_ROWS_ PROCESSED_PTR	SQLUENTIER *	ARD: Inutilisé APD: non utilisé IRD: R/W IPD: R/W	ARD: Inutilisé APD: non utilisé IRD: Ptr NULL IPD: Ptr NULL

la: Ces zones sont définies uniquement lorsque l'IPD est automatiquement renseigné par l' interface de ligne de commande. Si les zones ne sont pas renseignées automatiquement, elles ne sont pas définies. Si une application tente de définir ces zones, SQLSTATE HY091 (identificateur de zone de descripteur non valide.) sera renvoyé.

L'initialisation des zones d'enregistrement est la suivante:

Tableau 2. Initialisation des zones d'enregistrement
Zone d'enregistrement de descripteur	Type	Accessible en lecture et en écriture (R/W) ou en lecture seule (R)	Valeur d'initialisation
SQL_DESC_AUTO_UNIQUE_VALUE	SQLENTIER	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
SQL_DESC_BASE_COLUMN_NAME	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
SQL_DESC_BASE_TABLE_NAME	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
SQL_DESC_SENSIBLE à la casse	SQLENTIER	ARD: Inutilisé APD: non utilisé IRD: R IPD: R	ARD: Inutilisé APD: non utilisé IRD: D IPD: D ^a
SQL_DESC_NOM_CATALOGUE	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
SQL_DESC_CONCISE_TYPE	SQLSMALLINT	ARD: R/W APD: R/W IRD: R IPD: R/W	ARD: SQL_C_DEFAULT APD: SQL_C_DEFAULT IRD: D IPD: ND
SQL_DESC_DATA_PTR	POINT_SQL	ARD: R/W APD: R/W IRD: Inutilisé IPD: Inutilisé	ARD: Ptr NULL APD: Ptr NULL IRD: Inutilisé IPD: Inutilisé ^b
SQL_DESC_DATETIME_ CODE INTERVAL_CODE	SQLSMALLINT	ARD: R/W APD: R/W IRD: R IPD: R/W	ARD: ND APD: ND IRD: D IPD: ND
SQL_DESC_DATETIME_ INTERVAL_PRECISION	SQLENTIER	ARD: R/W APD: R/W IRD: R IPD: R/W	ARD: ND APD: ND IRD: D IPD: ND
TAILLE DES_DESC_AFFICHAGE	SQLENTIER	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
SQL_DESC_FIXED_PREC_SCALE	SQLSMALLINT	ARD: Inutilisé APD: non utilisé IRD: R IPD: R	ARD: Inutilisé APD: non utilisé IRD: D IPD: D ^a
VALEUR_IDENTIFICATION DES_SQL	SQLENTIER	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
SQL_DESC_INDICATOR_PTR	ENTIER SQL *	ARD: R/W APD: R/W IRD: Inutilisé IPD: Inutilisé	ARD: Ptr NULL APD: Ptr NULL IRD: Inutilisé IPD: Inutilisé
SQL_DESC_LABEL	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
LONGUEUR_DESC_SQL	SQLUENTIER	ARD: R/W APD: R/W IRD: R IPD: R/W	ARD: ND APD: ND IRD: D IPD: ND
PRÉFIXE_LETTRE_DESC_SQL	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
SUFFIXE_LETTRE_DESC_SQL	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
NOM_TYPE_LOCAL_DESC_SQL	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: R	ARD: Inutilisé APD: non utilisé IRD: D IPD: D ^a
NOM_DESC_SQL	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: R/W	ARD: ND APD: ND IRD: D IPD: ND
SQL_DESC_NULLABLE	SQLSMALLINT	ARD: Inutilisé APD: non utilisé IRD: R IPD: R	ARD: ND APD: ND IRD: N IPD: ND
SQL_DESC_NUM_PREC_RADIX	SQLENTIER	ARD: R/W APD: R/W IRD: R IPD: R/W	ARD: ND APD: ND IRD: D IPD: ND
LONGUEUR_OCTET_DESC_SQL	SQLENTIER	ARD: R/W APD: R/W IRD: R IPD: R/W	ARD: ND APD: ND IRD: D IPD: ND
SQL_DESC_OCTET_LENGTH_PTR	ENTIER SQL *	ARD: R/W APD: R/W IRD: Inutilisé IPD: Inutilisé	ARD: Ptr NULL APD: Ptr NULL IRD: Inutilisé IPD: Inutilisé
SQL_DESC_PARAMETER_TYPE	SQLSMALLINT	ARD: Inutilisé APD: non utilisé IPD: Inutilisé IRD: R/W	ARD: Inutilisé APD: non utilisé IPD: Inutilisé IRD: D=SQL_PARAM_INPUT
SQL_DESC_PRECISION	SQLSMALLINT	ARD: R/W APD: R/W IRD: R IPD: R/W	ARD: ND APD: ND IRD: D IPD: ND
SQL_DESC_SCALE	SQLSMALLINT	ARD: R/W APD: R/W IRD: R IPD: R/W	ARD: ND APD: ND IRD: D IPD: ND
SQL_DESC_SCHEMA_NAME	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
SQL_DESC_CONSULTABLE	SQLSMALLINT	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
SQL_DESC_TABLE_NAME	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
TYPE DE DESC_SQL	SQLSMALLINT	ARD: R/W APD: R/W IRD: R IPD: R/W	ARD: SQL_C_DEFAULT APD: SQL_C_DEFAULT IRD: D IPD: ND
NOM_TYPE_DESC_SQL	SQLCHAR *	ARD: Inutilisé APD: non utilisé IRD: R IPD: R	ARD: Inutilisé APD: non utilisé IRD: D IPD: D ^a
SQL_DESC_SANS nom	SQLSMALLINT	ARD: Inutilisé APD: non utilisé IRD: R IPD: R/W	ARD: ND APD: ND IRD: D IPD: ND
SQL_DESC_UNSIGNED	SQLSMALLINT	ARD: Inutilisé APD: non utilisé IRD: R IPD: R	ARD: Inutilisé APD: non utilisé IRD: D IPD: D ^a
SQL_DESC_UPDATABLE	SQLSMALLINT	ARD: Inutilisé APD: non utilisé IRD: R IPD: Inutilisé	ARD: Inutilisé APD: non utilisé IRD: D IPD: Inutilisé
Cardinalité SQL_DESC_CARDINALITY	SQLLEN	ARD: Inutilisé APD: R/W IRD: Inutilisé IPD: R/W	ARD: Inutilisé APD: D IRD: Inutilisé IPD: D
SQL_DESC_CARDINALITY_PTR	SQLLEN *	ARD: Inutilisé APD: R/W IRD: Inutilisé IPD: Inutilisé	ARD: Inutilisé APD: D IRD: Inutilisé IPD: Inutilisé

la: Ces zones sont définies uniquement lorsque l'IPD est automatiquement renseigné par l' interface de ligne de commande. Si les zones ne sont pas renseignées automatiquement, elles ne sont pas définies. Si une application tente de définir ces zones, SQLSTATE HY091 (identificateur de zone de descripteur non valide.) sera renvoyé.
b: La zone SQL_DESC_DATA_PTR de l'IPD peut être définie pour forcer un contrôle de cohérence. Dans un appel ultérieur à SQLGetDescField() ou à SQLGetDescRec(), l' interface de ligne de commande n'est pas requise pour renvoyer la valeur définie pour SQL_DESC_DATA_PTR.