Propriétés d'initialisation et d'autorisation
Le fournisseur OLE DB de SQL Server Native Client interprète les propriétés d'initialisation et d'autorisation OLE DB comme suit :
Identifiant de la propriété |
Description |
|---|---|
DBPROP_AUTH_CACHE_AUTHINFO |
Le fournisseur OLE DB de SQL Server Native Client ne met pas en cache les informations d'authentification. Le fournisseur OLE DB de SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d'une tentative de définition de la valeur de propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_AUTH_ENCRYPT_PASSWORD |
Le fournisseur OLE DB de SQL Server Native Client utilise des mécanismes de sécurité MicrosoftSQL Server standard pour masquer les mots de passe. Le fournisseur OLE DB de SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d'une tentative de définition de la valeur de propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_AUTH_INTEGRATED |
Si DBPROP_AUTH_INTEGRATED est défini à un pointeur NULL, une chaîne Null ou une valeur VT_BSTR « SSPI », le fournisseur OLE DB de SQL Server Native Client utilise le mode d'authentification Windows pour autoriser l'accès utilisateur à la base de données SQL Server spécifiée par les propriétés DBPROP_INIT_DATASOURCE et DBPROP_INIT_CATALOG. S'il a la valeur VT_EMPTY (valeur par défaut), la sécurité de SQL Server est utilisée. La connexion et le mot de passe SQL Server sont spécifiés dans les propriétés DBPROP_AUTH_USERID et DBPROP_AUTH_PASSWORD. |
DBPROP_AUTH_MASK_PASSWORD |
Le fournisseur OLE DB de SQL Server Native Client utilise des mécanismes de sécurité SQL Server standard pour masquer les mots de passe. Le fournisseur OLE DB de SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d'une tentative de définition de la valeur de propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_AUTH_PASSWORD |
Mot de passe assigné à une connexion SQL Server. Cette propriété est utilisée lorsque l'authentification SQL Server est sélectionnée pour autoriser ou non l'accès à une base de données SQL Server. |
DBPROP_AUTH_PERSIST_ENCRYPTED |
Le fournisseur OLE DB de SQL Server Native Client ne chiffre pas les informations d'authentification lorsqu'elles sont persistantes. Le fournisseur OLE DB de SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d'une tentative de définition de la valeur de propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
Le fournisseur OLE DB de SQL Server Native Client rend les valeurs d'authentification persistantes, y compris l'image d'un mot de passe, si cela est demandé. Aucun chiffrement n'est fourni. |
DBPROP_AUTH_USERID |
Connexion SQL Server. Cette propriété est utilisée lorsque l'authentification SQL Server est sélectionnée pour autoriser ou non l'accès à une base de données SQL Server. |
DBPROP_INIT_ASYNCH |
Le fournisseur OLE DB de SQL Server Native Client prend en charge l'initialisation asynchrone. La définition de DBPROPVAL_ASYNCH_INITIALIZE dans la propriété DBPROP_INIT_ASYNCH oblige IDBInitialize::Initialize à devenir un appel non bloquant. Pour plus d'informations, consultez Exécution d'opérations asynchrones. |
DBPROP_INIT_CATALOG |
Nom d'une base de données SQL Server existante à laquelle se connecter. |
DBPROP_INIT_DATASOURCE |
Nom réseau d'un serveur exécutant une instance de MicrosoftSQL Server. If there are multiple instances of SQL Server running on the computer, in order to connect to a specific instance of SQL Server the value DBPROP_INIT_DATASOURCE is specified as \\ServerName\InstanceName. La séquence d'échappement \\ est utilisée pour la barre oblique inverse. |
DBPROP_INIT_GENERALTIMEOUT |
Indique le nombre de secondes avant l'expiration d'une requête (sauf l'initialisation d'une source de données et l'exécution d'une commande). Une valeur égale à 0 indique un délai illimité. Les fournisseurs qui opèrent via des connexions réseau ou selon des scénarios distribués ou transactionnels peuvent prendre en charge cette propriété afin d'indiquer à un composant inscrit quel est le délai d'expiration lorsqu'une requête met du temps à s'exécuter. Les délais d'expiration pour l'initialisation d'une source de données et l'exécution d'une commande restent contrôlés par DBPROP_INIT_TIMEOUT et DBPROP_COMMANDTIMEOUT, respectivement. DBPROP_INIT_GENERALTIMEOUT est en lecture seule ; par conséquent, toute tentative de définition de la propriété retourne l'erreur dwstatus de DBPROPSTATUS_NOTSETTABLE. |
DBPROP_INIT_HWND |
Handle de fenêtre de l'application appelante. Un handle de fenêtre valide est requis pour la boîte de dialogue d'initialisation affichée lorsque la demande des propriétés d'initialisation est autorisée. |
DBPROP_INIT_IMPERSONATION_LEVEL |
Le fournisseur OLE DB de SQL Server Native Client ne prend pas en charge l'ajustement du niveau d'emprunt d'identité. Le fournisseur OLE DB de SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d'une tentative de définition de la valeur de propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_INIT_LCID |
Le fournisseur OLE DB de SQL Server Native Client valide l'ID de paramètres régionaux et retourne une erreur si cet ID de paramètres régionaux n'est pas pris en charge ou n'est pas installé sur le client. |
DBPROP_INIT_LOCATION |
Le fournisseur OLE DB de SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d'une tentative de définition de la valeur de propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_INIT_MODE |
Le fournisseur OLE DB de SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d'une tentative de définition de la valeur de propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_INIT_PROMPT |
Le fournisseur OLE DB de SQL Server Native Client prend en charge tous les modes d'invite pour l'initialisation de la source de données. Le fournisseur OLE DB de SQL Server Native Client utilise DBPROMPT_NOPROMPT comme paramètre par défaut pour la propriété. |
DBPROP_INIT_PROTECTION_LEVEL |
Le fournisseur OLE DB de SQL Server Native Client ne prend en charge aucun niveau de protection sur les connexions aux instances de SQL Server. Le fournisseur OLE DB de SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d'une tentative de définition de la valeur de propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_INIT_PROVIDERSTRING |
Consultez les informations relatives à la chaîne du fournisseur OLE DB de SQL Server Native Client plus loin dans cette rubrique. |
DBPROP_INIT_TIMEOUT |
Le fournisseur OLE DB de SQL Server Native Client retourne une erreur lors de l'initialisation si une connexion à l'instance de SQL Server ne peut pas être établie au cours du délai spécifié en secondes. |
Dans le jeu de propriétés DBPROPSET_SQLSERVERDBINIT spécifique au fournisseur, le fournisseur OLE DB de SQL Server Native Client définit ces propriétés d'initialisation supplémentaires.
Identifiant de la propriété |
Description |
|---|---|
SSPROP_AUTH_OLD_PASSWORD |
Type : VT_BSTR L/E (Lecture/Écriture) : écriture Valeur par défaut : VT_EMPTY Description : mot de passe actuel ou expiré. Pour plus d'informations, consultez Modification des mots de passe par programme. |
SSPROP_INIT_APPNAME |
Type : VT_BSTR L/E (Lecture/Écriture) : lecture/écriture Description : nom de l'application cliente. |
SSPROP_INIT_AUTOTRANSLATE |
Type : VT_BOOL L/E (Lecture/Écriture) : lecture/écriture Valeur par défaut : VARIANT_TRUE Description : conversion de caractères OEM/ANSI. VARIANT_TRUE : le fournisseur OLE DB de SQL Server Native Client traduit les chaînes de caractères ANSI transmises entre le client et le serveur en les convertissant au format Unicode afin de réduire les problèmes lors de la correspondance des caractères étendus entre les pages de codes sur le client et le serveur : Les données DBTYPE_STR clientes envoyées à une instance de variable, paramètre ou colonne SQL Server de type char, varchar ou text, sont converties du format caractère au format Unicode via la page de codes ANSI cliente, puis sont converties du format Unicode au format caractère via la page de codes ANSI du serveur. Les données SQL Server de type char, varchar ou text envoyées à une variable DBTYPE_STR cliente sont converties du format caractère au format Unicode via la page de codes ANSI du serveur, puis sont converties du format Unicode au format caractère via la page de codes ANSI du client. Ces conversions sont effectuées sur le client par le fournisseur OLE DB de SQL Server Native Client. Cela requiert l'utilisation de la même page de codes ANSI sur le serveur et sur le client. Ces paramètres n'ont aucun effet sur les conversions effectuées pour les transferts suivants : Données clientes DBTYPE_WSTR Unicode envoyées aux données de type char, varchar ou text sur le serveur. Données de serveur de type char, varchar ou text envoyées à une variable DBTYPE_WSTR Unicode sur le client. Données clientes ANSI DBTYPE_STR envoyées aux données Unicode de type nchar, nvarchar ou ntext sur le serveur. Données de serveur Unicode de type char, varchar ou text envoyées à une variable ANSI DBTYPE_STR sur le client. VARIANT_FALSE : le fournisseur OLE DB de SQL Server Native Client n'effectue pas de traductions des caractères. Le fournisseur OLE DB de SQL Server Native Client ne traduit pas les données clientes ANSI DBTYPE_STR envoyées aux variables, paramètres ou colonnes de type char, varchar ou text sur le serveur. Aucune traduction n'est effectuée pour les données de type char, varchar ou text envoyées du serveur aux variables DBTYPE_STR sur le client. Si le client et l'instance de SQL Server utilisent des pages de codes ANSI différentes, les caractères étendus peuvent être mal interprétés. |
SSPROP_INIT_CURRENTLANGUAGE |
Type : VT_BSTR L/E (Lecture/Écriture) : lecture/écriture Description : langue de SQL Server. Identifie la langue utilisée pour le choix et la mise en forme des messages système. La langue doit être installée sur l'ordinateur exécutant une instance de SQL Server, sinon l'initialisation de la source de données échoue. |
SSPROP_INIT_DATATYPECOMPATIBILITY |
Type : VT_UI2 L/E (Lecture/Écriture) : lecture/écriture Valeur par défaut : 0 Description : active la compatibilité du type de données entre les applications SQL Server et ADO (ActiveX Data Object). Si la valeur par défaut 0 est utilisée, le type de données géré par défaut est celui du fournisseur. Si la valeur 80 est utilisée, les types de données gérés sont uniquement ceux de SQL Server 2000. Pour plus d'informations, consultez Utilisation d'ADO avec SQL Server Native Client. |
SSPROP_INIT_ENCRYPT |
Type : VT_BOOL L/E (Lecture/Écriture) : lecture/écriture Valeur par défaut : VARIANT_FALSE Description : pour chiffrer les données qui sont transmises sur le réseau, la propriété SSPROP_INIT_ENCRYPT a la valeur VARIANT_TRUE. Si la fonctionnalité de chiffrement de protocole est activée, le chiffrement est systématiquement effectué, indépendamment de la valeur de SSPROP_INIT_ENCRYPT. Si cette fonctionnalité est désactivée et si SSPROP_INIT_ENCRYPT a la valeur VARIANT_TRUE, le chiffrement est effectué. Si la fonctionnalité de chiffrement de protocole est désactivée et si SSPROP_INIT_ENCRYPT a la valeur VARIANT_FALSE, aucun chiffrement n'est effectué. |
SSPROP_INIT_FAILOVERPARTNER |
Type : VT_BSTR L/E (Lecture/Écriture) : lecture/écriture Description : indique le nom du partenaire de basculement pour la mise en miroir de bases de données. Il s'agit d'une propriété d'initialisation qui ne peut être définie qu'avant l'initialisation. Après l'initialisation, elle retourne le nom du partenaire de basculement (s'il existe), qui est retourné par le serveur principal. Cela permet à une application intelligente de mettre en cache le serveur de sauvegarde le plus récent ; toutefois, de telles applications doivent prendre en compte le fait que les informations sont mises à jour uniquement lorsque la connexion est établie au préalable (ou lorsqu'elle est réinitialisée, en cas de regroupement), et que ces informations peuvent devenir obsolètes dans le cas des connexions à long terme. Après avoir établi la connexion, l'application peut interroger cet attribut pour déterminer l'identité du partenaire de basculement. Si le serveur principal n'a aucun partenaire de basculement, cette propriété retourne une chaîne vide. Pour plus d'informations, consultez Utilisation de la mise en miroir de bases de données. |
SSPROP_INIT_FILENAME |
Type : VT_BSTR L/E (Lecture/Écriture) : lecture/écriture Description : indique le nom du fichier primaire d'une base de données pouvant être attachée. Cette base de données est attachée et devient la base de données par défaut de la connexion. Pour utiliser SSPROP_INIT_FILENAME, vous devez spécifier le nom de la base de données en tant que valeur de la propriété d'initialisation DBPROP_INIT_CATALOG. Si le nom de la base de données n'existe pas, la propriété recherche le nom de fichier primaire spécifié dans SSPROP_INIT_FILENAME, puis attache cette base de données avec le nom spécifié dans DBPROP_INIT_CATALOG. Si la base de données a été attachée précédemment, SQL Server ne l'attache pas de nouveau. |
SSPROP_INIT_MARSCONNECTION |
Type : VT_BOOL L/E (Lecture/Écriture) : lecture/écriture Valeur par défaut : VARIANT_FALSE Description : indique si MARS (Multiple Active Result Sets) est activé pour la connexion. Cette option doit être définie à true avant l'établissement d'une connexion à la base de données. Pour plus d'informations, consultez Utilisation de MARS (Multiple Active Result Sets). |
SSPROP_INIT_NETWORKADDRESS |
Type : VT_BSTR L/E (Lecture/Écriture) : lecture/écriture Description : adresse réseau du serveur exécutant une instance de SQL Server spécifiée par la propriété DBPROP_INIT_DATASOURCE. |
SSPROP_INIT_NETWORKLIBRARY |
Type : VT_BSTR L/E (Lecture/Écriture) : lecture/écriture Description : nom de la bibliothèque réseau (DLL) utilisée pour communiquer avec une instance de SQL Server. Le nom ne doit pas inclure le chemin d'accès ni l'extension de nom de fichier .dll. La valeur par défaut peut être personnalisée à l'aide de l'utilitaire de configuration de client SQL Server.
|
SSPROP_INIT_PACKETSIZE |
Type : VT_I4 L/E (Lecture/Écriture) : lecture/écriture Description : taille d'un paquet réseau en octets. La valeur de propriété relative à la taille du paquet doit être comprise entre 512 et 32 767. La taille de paquet par défaut du fournisseur OLE DB de SQL Server Native Client est 4 096. |
SSPROP_INIT_TAGCOLUMNCOLLATION |
Type : BOOL L/E (Lecture/Écriture) : écriture Valeur par défaut : FALSE Description : propriété utilisée pendant une mise à jour de base de données avec les curseurs côté serveur. Elle balise les données avec les informations de classement obtenues à partir du serveur au lieu de la page de codes du client. Actuellement, cette propriété est utilisée uniquement par le processus de requête distribuée, car elle connaît le classement des données de destination et le convertit de manière appropriée. |
SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
Type : VT_BOOL L/E (Lecture/Écriture) : lecture/écriture Valeur par défaut : VARIANT_FALSE Description : permet d'activer ou de désactiver la validation du certificat de serveur. Cette propriété est en lecture/écriture, mais toute tentative pour la définir après qu'une connexion a été établie provoque une erreur. Cette propriété est ignorée si le client est configuré pour exiger une validation de certificat. Toutefois, une application peut l'utiliser conjointement avec SSPROP_INIT_ENCRYPT pour garantir que sa connexion au serveur est chiffrée, même si le client est configuré pour ne pas exiger de chiffrement et si aucun certificat n'est fourni sur le client. Les applications clientes peuvent interroger cette propriété après qu'une connexion a été ouverte pour déterminer le chiffrement effectif et les paramètres de validation utilisés.
Pour plus d'informations, consultez Utilisation du chiffrement sans validation. |
SSPROP_INIT_USEPROCFORPREP |
Type : VT_I4 L/E (Lecture/Écriture) : lecture/écriture Valeur par défaut : SSPROPVAL_USEPROCFORPREP_ON Description : utilisation de la procédure stockée SQL Server. Définit l'utilisation des procédures stockées temporaires SQL Server pour permettre la prise en charge de l'interface ICommandPrepare. Cette propriété était utile uniquement lors d'une connexion à SQL Server 6.5. Elle est ignorée dans les versions ultérieures. SSPROPVAL_USEPROCFORPREP_OFF : aucune procédure stockée temporaire n'est créée lorsqu'une commande est préparée. SSPROPVAL_USEPROCFORPREP_ON : une procédure stockée temporaire est créée lorsqu'une commande est préparée. Les procédures stockées temporaires sont supprimées lorsque la session est libérée. SSPROPVAL_USEPROCFORPREP_ON_DROP : une procédure stockée temporaire est créée lorsqu'une commande est préparée. La procédure est supprimée lorsque la préparation de la commande est annulée avec ICommandPrepare::Unprepare, lorsqu'une nouvelle commande est spécifiée pour l'objet Command avec ICommandText::SetCommandText ou lorsque toutes les références d'application à la commande sont libérées. |
SSPROP_INIT_WSID |
Type : VT_BSTR L/E (Lecture/Écriture) : lecture/écriture Description : chaîne identifiant la station de travail. |
Dans le jeu de propriétés DBPROPSET_SQLSERVERDATASOURCEINFO spécifique au fournisseur, le fournisseur OLE DB de SQL Server Native Client définit les propriétés supplémentaires ; consultez Propriétés des informations de la source de données pour plus d'informations.
Chaîne du fournisseur OLE DB de SQL Server Native Client
Le fournisseur OLE DB de SQL Server Native Client reconnaît la syntaxe ODBC dans les valeurs de propriétés de la chaîne du fournisseur. La propriété de chaîne du fournisseur est fournie en tant que valeur de la propriété d'initialisation OLE DB DBPROP_INIT_PROVIDERSTRING lorsqu'une connexion est établie à la source de données OLE DB. Cette propriété indique les données de connexion OLE DB spécifiques au fournisseur, qui sont requises pour implémenter une connexion à la source de données OLE DB. Dans la chaîne, les éléments sont délimités à l'aide d'un point-virgule. Le dernier élément de la chaîne doit se terminer par un point-virgule. Chaque élément comprend un mot clé, le signe égal et la valeur passée lors de l'initialisation. Par exemple :
Server=MyServer;UID=MyUserName;
Avec le fournisseur OLE DB de SQL Server Native Client, le consommateur n'a jamais besoin d'utiliser la propriété de chaîne du fournisseur. Le consommateur peut définir les propriétés d'initialisation de la chaîne du fournisseur en utilisant OLE DB ou les propriétés d'initialisation spécifiques au fournisseur OLE DB de SQL Server Native Client.
Pour obtenir une liste des mots clés disponibles dans le fournisseur OLE DB de SQL Server Native Client, consultez Utilisation de mots clés de chaîne de connexion avec SQL Server Native Client.