Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le fournisseur OLE DB SQL Server Native Client interprète les propriétés d’initialisation et d’autorisation OLE DB comme suit :
| ID de propriété | Descriptif |
|---|---|
| DBPROP_AUTH_CACHE_AUTHINFO | Le fournisseur OLE DB SQL Server Native Client ne met pas en cache les informations d’authentification. Le fournisseur OLE DB SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d’une tentative de définition de la valeur de la propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_ENCRYPT_PASSWORD | Le fournisseur OLE DB SQL Server Native Client utilise des mécanismes de sécurité MicrosoftSQL Server standard pour masquer les mots de passe. Le fournisseur OLE DB SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d’une tentative de définition de la valeur de la propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_INTEGRATED | Si DBPROP_AUTH_INTEGRATED est défini sur un pointeur NULL, une chaîne null ou une valeur VT_BSTR « SSPI », le fournisseur OLE DB 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 est défini sur VT_EMPTY (valeur par défaut), la sécurité 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 SQL Server Native Client utilise des mécanismes de sécurité SQL Server standard pour masquer les mots de passe. Le fournisseur OLE DB SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d’une tentative de définition de la valeur de la propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_PASSWORD | Mot de passe affecté à une connexion SQL Server. Cette propriété est utilisée lorsque l’authentification SQL Server est sélectionnée pour autoriser l’accès à une base de données SQL Server. |
| DBPROP_AUTH_PERSIST_ENCRYPTED | Le fournisseur OLE DB SQL Server Native Client ne chiffre pas les informations d’authentification lorsqu’elles sont conservées. Le fournisseur OLE DB SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d’une tentative de définition de la valeur de la propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Le fournisseur OLE DB SQL Server Native Client conserve les valeurs d’authentification, y compris une image d’un mot de passe, si nécessaire. 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 l’accès à une base de données SQL Server. |
| DBPROP_INIT_ASYNCH | Le fournisseur OLE DB SQL Server Native Client prend en charge l’initiation asynchrone. Si vous définissez le bit DBPROPVAL_ASYNCH_INITIALIZE dans la propriété DBPROP_INIT_ASYNCH, IDBInitialize ::Initialize devient un appel non bloquant. Pour plus d’informations, consultez Effectuer des opérations asynchrones. |
| DBPROP_INIT_CATALOG (Catalogue d'initialisation de la base de données) | 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. S’il existe plusieurs instances de SQL Server en cours d’exécution sur l’ordinateur, afin de se connecter à une instance spécifique de SQL Server, la valeur DBPROP_INIT_DATASOURCE est spécifiée en tant que \\ServerName\InstanceName. La séquence d’échappement \\ est utilisée pour la barre oblique inverse elle-même. |
| DBPROP_INIT_GENERALTIMEOUT | Indique le nombre de secondes avant une requête, autre que l’initialisation de la source de données et l’exécution des commandes, expire. La valeur 0 indique un délai d’attente infini. Les fournisseurs qui fonctionnent sur des connexions réseau ou dans des scénarios distribués ou traités peuvent prendre en charge cette propriété pour conseiller un composant inscrit à expirer en cas de demande de longue durée. Les délais d’attente pour l’initialisation de la source de données et l’exécution des commandes restent régis par DBPROP_INIT_TIMEOUT et DBPROP_COMMANDTIMEOUT, respectivement. DBPROP_INIT_GENERALTIMEOUT est en lecture seule et si vous tentez de définir l’erreur dwstatus de DBPROPSTATUS_NOTSETTABLE est retournée. |
| DBPROP_INIT_HWND | Handle Windows à partir de l’application appelante. Un handle de fenêtre valide est requis pour la boîte de dialogue d’initialisation affichée lorsque vous êtes invité à entrer des propriétés d’initialisation est autorisée. |
| DBPROP_INIT_IMPERSONATION_LEVEL | Le fournisseur OLE DB SQL Server Native Client ne prend pas en charge l’ajustement du niveau d’emprunt d’identité. Le fournisseur OLE DB SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d’une tentative de définition de la valeur de la propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_LCID | Le fournisseur OLE DB SQL Server Native Client valide l’ID de paramètres régionaux et retourne une erreur si l’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 SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d’une tentative de définition de la valeur de la propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_MODE | Le fournisseur OLE DB SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d’une tentative de définition de la valeur de la propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_PROMPT | Le fournisseur OLE DB 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 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 SQL Server Native Client ne prend pas en charge un niveau de protection sur les connexions aux instances de SQL Server. Le fournisseur OLE DB SQL Server Native Client retourne DB_S_ERRORSOCCURRED lors d’une tentative de définition de la valeur de la propriété. Le membre dwStatus de la structure DBPROP indique DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_PROVIDERSTRING | Consultez la chaîne du fournisseur OLE DB SQL Server Native Client plus loin dans cette rubrique. |
| DBPROP_INIT_TIMEOUT | Le fournisseur OLE DB 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 nombre de secondes spécifié. |
Dans le jeu de propriétés spécifique au fournisseur DBPROPSET_SQLSERVERDBINIT, le fournisseur OLE DB SQL Server Native Client définit ces propriétés d’initialisation supplémentaires.
| ID de propriété | Descriptif |
|---|---|
| SSPROP_AUTH_OLD_PASSWORD | Type : VT_BSTR R/W : Écriture Par défaut : VT_EMPTY Description : mot de passe actuel ou expiré. Pour plus d’informations, consultez Modification des mots de passe par programmation. |
| SSPROP_INIT_APPNAME | Type : VT_BSTR R/W : lecture/écriture Description : nom de l’application cliente. |
| SSPROP_INIT_AUTOTRANSLATE | Type : VT_BOOL R/W : lecture/écriture Par défaut : VARIANT_TRUE Description : conversion de caractères OEM/ANSI. VARIANT_TRUE : le fournisseur OLE DB SQL Server Native Client traduit les chaînes de caractères ANSI envoyées entre le client et le serveur en convertissant via Unicode pour réduire les problèmes liés aux caractères étendus correspondants entre les pages de code du client et le serveur : Le client DBTYPE_STR données envoyées à une instance de SQL Serverchar, varchar ou variable de texte , paramètre ou colonne est convertie de caractère en Unicode à l’aide de la page de codes ANSI cliente (ACP), puis convertie d’Unicode en caractère à l’aide de l’ACP du serveur. Les données char,varchar ou texte SQL Server envoyées à une variable de DBTYPE_STR client sont converties de caractère en Unicode à l’aide du serveur ACP, puis converties d’Unicode en caractères à l’aide de l’ACP client. Ces conversions sont effectuées sur le client par le fournisseur OLE DB SQL Server Native Client. Cela nécessite que le même ACP utilisé sur le serveur soit disponible sur le client. Ces paramètres n’ont aucun effet sur les conversions qui se produisent pour ces transferts : Unicode DBTYPE_WSTR données clientes envoyées à char, varchar ou texte sur le serveur. données char, varchar ou serveur de texte envoyées à une variable de DBTYPE_WSTR Unicode sur le client. ANSI DBTYPE_STR données clientes envoyées à Unicode nchar, nvarchar ou ntext sur le serveur. Caractères Unicode, varchar ou données de serveur de texte envoyées à une variable ANSI DBTYPE_STR sur le client. VARIANT_FALSE : le fournisseur OLE DB SQL Server Native Client n’effectue pas de traductions de caractères. Le fournisseur OLE DB SQL Server Native Client ne traduit pas le caractère ANSI client DBTYPE_STR données envoyées en caractères, varchar ou variables de texte , paramètres ou colonnes sur le serveur. Aucune traduction n’est effectuée sur les données char, varchar ou texte envoyées du serveur à DBTYPE_STR variables sur le client. Si le client et l’instance de SQL Server utilisent des listes de contrôle d’accès différentes, les caractères étendus peuvent être mal interprétés. |
| SSPROP_INIT_CURRENTLANGUAGE | Type : VT_BSTR R/W : lecture/écriture Description : nom du langage SQL Server. Identifie la langue utilisée pour la sélection 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 ou l’initialisation de source de données échoue. |
| SSPROP_INIT_DATATYPECOMPATIBILITY | Type : VT_UI2 R/W : lecture/écriture Valeur par défaut : 0 Description : active la compatibilité des types de données entre les applications SQL Server et ActiveX Data Object (ADO). Si la valeur par défaut 0 est utilisée, le type de données gère par défaut celui utilisé par le fournisseur. Si la valeur 80 est utilisée, la gestion des types de données utilise uniquement les types de données SQL Server 2000. Pour plus d’informations, consultez Utilisation d’ADO avec SQL Server Native Client. |
| SSPROP_INIT_ENCRYPT | Type : VT_BOOL R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : Pour chiffrer les données sur le réseau, SSPROP_INIT_ENCRYPT propriété est définie sur VARIANT_TRUE. Si l’option Activer le chiffrement du protocole est activée, le chiffrement se produit toujours, quel que soit le paramètre de SSPROP_INIT_ENCRYPT. S’il est désactivé et SSPROP_INIT_ENCRYPT est défini sur VARIANT_TRUE, le chiffrement se produit. Si Activer le chiffrement du protocole est désactivé et que SSPROP_INIT_ENCRYPT est défini sur VARIANT_FALSE, aucun chiffrement ne se produit. |
| SSPROP_INIT_FAILOVERPARTNER | Type : VT_BSTR R/W : lecture/écriture Description : spécifie 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 et ne peut être définie qu’avant l’initialisation. Après l’initialisation, il retourne le partenaire de basculement, le cas échéant, retourné par le serveur principal. Cela permet à une application intelligente de mettre en cache le serveur de sauvegarde le plus récemment déterminé, mais ces applications doivent être conscientes que les informations sont mises à jour uniquement lorsque la connexion est établie pour la première fois (ou réinitialisée, si elle est mise en pool) et peut devenir obsolète pour les connexions à long terme. Une fois la connexion établie, 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 R/W : lecture/écriture Description : spécifie le nom de fichier principal d’une base de données joignable. Cette base de données est attachée et devient la base de données par défaut pour la connexion. Pour utiliser SSPROP_INIT_FILENAME, vous devez spécifier le nom de la base de données comme valeur de la propriété d’initialisation DBPROP_INIT_CATALOG. Si le nom de la base de données n’existe pas, il recherche le nom de fichier principal spécifié dans SSPROP_INIT_FILENAME et attache cette base de données avec le nom spécifié dans DBPROP_INIT_CATALOG. Si la base de données a été précédemment attachée, SQL Server ne la détache pas. |
| SSPROP_INIT_MARSCONNECTION | Type : VT_BOOL R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : spécifie si plusieurs jeux de résultats actifs (MARS) sont activés pour la connexion. Cette option doit être définie sur true avant qu’une connexion soit établie à la base de données. Pour plus d’informations, consultez Utilisation de MARS (Multiple Active Result Sets). |
| SSPROP_INIT_NETWORKADDRESS | Type : VT_BSTR R/W : 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 R/W : lecture/écriture Description : nom de la DLL (networklibrary) 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 du client SQL Server. Note: Seuls tcp et canaux nommés sont pris en charge par cette propriété. Si vous utilisez cette propriété avec un préfixe, vous finissent par un double préfixe qui entraîne une erreur, car la propriété est utilisée pour générer un préfixe en interne. |
| SSPROP_INIT_PACKETSIZE | Type : VT_I4 R/W : lecture/écriture Description : taille de paquet réseau en octets. La valeur de la propriété de taille de paquet doit être comprise entre 512 et 32 767. La taille de paquet réseau du fournisseur OLE DB SQL Server Native Client par défaut est de 4 096. |
| SSPROP_INIT_TAGCOLUMNCOLLATION | Type : BOOL R/W : Écriture Valeur par défaut : FALSE Description : est utilisée lors d’une mise à jour de base de données lorsque des curseurs côté serveur sont utilisés. Cette propriété balise les données avec des 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é, car elle connaît le classement des données de destination et la convertit correctement. |
| SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Type : VT_BOOL R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : permet d’activer ou de désactiver la validation des certificats de serveur. Cette propriété est en lecture/écriture, mais la tentative de la définir une fois qu’une connexion a été établie entraîne une erreur. Cette propriété est ignorée si le client est configuré pour exiger la validation de certificat. Toutefois, une application peut l’utiliser avec SSPROP_INIT_ENCRYPT pour garantir que sa connexion au serveur est chiffrée, même si le client n’est pas configuré pour exiger le chiffrement et qu’aucun certificat n’est provisionné sur le client. Les applications clientes peuvent interroger cette propriété une fois qu’une connexion a été ouverte pour déterminer les paramètres de chiffrement et de validation réels en cours d’utilisation. Note: L’utilisation du chiffrement sans validation de certificat offre une protection partielle contre la détection de paquets, mais elle ne protège pas contre les attaques man-in-the-middle. Il permet simplement de chiffrer la connexion et les données envoyées au serveur sans valider le certificat de serveur. Pour plus d’informations, consultez Utilisation du chiffrement sans validation. |
| SSPROP_INIT_USEPROCFORPREP | Type : VT_I4 R/W : lecture/écriture Valeur par défaut : SSPROPVAL_USEPROCFORPREP_ON Description : utilisation de la procédure stockée SQL Server. Définit l’utilisation de procédures stockées temporaires SQL Server pour prendre en charge l’interface ICommandPrepare . Cette propriété était significative uniquement lors de la connexion à SQL Server 6.5. La propriété est ignorée pour les versions ultérieures. SSPROPVAL_USEPROCFORPREP_OFF : une procédure stockée temporaire n’est pas 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 lors de la publication de la session. 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 commande n’est pas préparée avec ICommandPrepare ::Unprepare, lorsqu’une nouvelle commande est spécifiée pour l’objet de commande avec ICommandText ::SetCommandText, ou lorsque toutes les références d’application à la commande sont libérées. |
| SSPROP_INIT_WSID | Type : VT_BSTR R/W : lecture/écriture Description : chaîne identifiant la station de travail. |
Dans le jeu de propriétés spécifique au fournisseur DBPROPSET_SQLSERVERDATASOURCEINFO, le fournisseur OLE DB SQL Server Native Client définit les propriétés supplémentaires ; pour plus d’informations, consultez Propriétés des informations de source de données .
Chaîne du fournisseur OLE DB SQL Server Native Client
Le fournisseur OLE DB SQL Server Native Client reconnaît une syntaxe de type ODBC dans les valeurs de propriété de chaîne de fournisseur. La propriété de chaîne de fournisseur est fournie comme 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é spécifie les données de connexion propres au fournisseur OLE DB 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. L’élément final de la chaîne doit être arrêté avec un point-virgule. Chaque élément se compose d’un mot clé, d’un caractère de signe égal et de la valeur transmise à l’initialisation. Par exemple:
Server=MyServer;UID=MyUserName;
Avec le fournisseur OLE DB SQL Server Native Client, le consommateur n’a jamais besoin d’utiliser la propriété de chaîne de fournisseur. Le consommateur peut définir n’importe quelle propriété d’initialisation reflétée dans la chaîne de fournisseur à l’aide des propriétés d’initialisation propres au fournisseur OLE DB OLE DB ou SQL Server Native Client.
Pour obtenir la liste des mots clés disponibles dans le fournisseur OLE DB SQL Server Native Client, consultez Utilisation de mots clés de chaîne de connexion avec SQL Server Native Client.