SQLInstallDriverManager, fonction

Conformité
Version introduite : ODBC 1.0 : déconseillée dans Windows XP Service Pack 2, Windows Server 2003 Service Pack 1 et systèmes d’exploitation ultérieurs

Résumé
SQLInstallDriverManager retourne le chemin du répertoire cible pour l’installation des composants principaux ODBC. Le programme appelant doit en fait copier les fichiers du Gestionnaire de pilotes dans le répertoire cible.

Syntaxe

  
BOOL SQLInstallDriverManager(  
     LPSTR    lpszPath,  
     WORD     cbPathMax,  
     WORD *   pcbPathOut);  

Arguments

lpszPath
[Sortie] Chemin du répertoire cible de l’installation.

cbPathMax
[Entrée] Longueur de lpszPath. Il doit s’agir d’au moins _MAX_PATH octets.

pcbPathOut
[Sortie] Nombre total d’octets (à l’exception de l’octet de terminaison Null) retournés dans lpszPath. Si le nombre d’octets disponibles à retourner est supérieur ou égal à cbPathMax, le chemin d’accès dans lpszPath est tronqué en cbPathMax moins le caractère de terminaison Null. L’argument pcbPathOut peut être un pointeur null.

Retours

La fonction retourne TRUE si elle réussit, FALSE en cas d’échec.

Diagnostics

Lorsque SQLInstallDriverManager retourne FALSE, une valeur *pfErrorCode associée peut être obtenue en appelant SQLInstallerError. Le tableau suivant répertorie les valeurs *pfErrorCode qui peuvent être retournées par SQLInstallerError et explique chacune d’elles dans le contexte de cette fonction.

*pfErrorCode	Error	Description
ODBC_ERROR_GENERAL_ERR	Erreur générale du programme d’installation	Une erreur s’est produite pour laquelle il n’y avait pas d’erreur de programme d’installation spécifique.
ODBC_ERROR_INVALID_BUFF_LEN	Longueur de la mémoire tampon non valide	L’argument lpszPath n’était pas assez grand pour contenir le chemin de sortie. La mémoire tampon contient le chemin d’accès tronqué. L’argument cbPathMax était inférieur à _MAX_PATH.
ODBC_ERROR_USAGE_UPDATE_FAILED	Impossible d’incrémenter ou de décrémenter le nombre d’utilisations des composants	Le programme d’installation n’a pas pu incrémenter le nombre d’utilisations des composants principaux ODBC.
ODBC_ERROR_OUT_OF_MEM	Mémoire insuffisante	Le programme d’installation n’a pas pu effectuer la fonction en raison d’un manque de mémoire.

Commentaires

SQLInstallDriverManager est appelé pour retourner le chemin des composants principaux ODBC et incrémenter le nombre d’utilisation des composants dans les informations système. Si une version du Gestionnaire de pilotes existe déjà, mais que le nombre d’utilisation des composants pour le pilote n’existe pas, la nouvelle valeur du nombre d’utilisation des composants est définie sur 2.

Le programme d’installation de l’application est chargé de copier physiquement les fichiers de composants principaux et de maintenir le nombre d’utilisations de fichiers. Si aucun fichier de composant principal n’a été installé précédemment, le programme d’installation de l’application doit copier le fichier et créer le nombre d’utilisations de fichiers. Si le fichier a été installé précédemment, le programme d’installation incrémente simplement le nombre d’utilisations de fichiers.

Si une version antérieure du Gestionnaire de pilotes a été précédemment installée par le programme d’installation de l’application, les composants principaux doivent être désinstallés, puis réinstallés, afin que le nombre d’utilisations des composants principaux soit valide. SQLRemoveDriverManager doit d’abord être appelé pour décrémenter le nombre d’utilisation des composants. SQLInstallDriverManager doit ensuite être appelé pour incrémenter le nombre d’utilisation des composants. Le programme d’installation de l’application doit remplacer les anciens fichiers de composants principaux par les nouveaux fichiers. Le nombre d’utilisations de fichiers reste le même, et les autres applications qui utilisaient les anciens fichiers de composants de base de version utilisent désormais les fichiers de version plus récents.

Dans une nouvelle installation des principaux composants, pilotes et traducteurs ODBC, le programme d’installation d’application doit appeler les fonctions suivantes dans l’ordre : SQLInstallDriverManager, SQLInstallDriverEx, SQLConfigDriver (avec une requête fRequest de ODBC_INSTALL_DRIVER), puis SQLInstallTranslatorEx. Dans une désinstallation des principaux composants, pilotes et traducteurs, le programme d’installation de l’application doit appeler les fonctions suivantes dans l’ordre : SQLRemoveTranslator, SQLRemoveDriver, puis SQLRemoveDriverManager. Ces fonctions doivent être appelées dans cette séquence. Dans une mise à niveau de tous les composants, toutes les fonctions de désinstallation doivent être appelées dans l’ordre, puis toutes les fonctions d’installation doivent être appelées dans l’ordre.

Fonctions connexes

Pour obtenir des informations sur	Consultez
Ajout, modification ou suppression d’un pilote	SQLConfigDriver
Installation d’un pilote	SQLInstallDriverEx
Installation d’un traducteur	SQLInstallTranslatorEx
Suppression d’un pilote	SQLRemoveDriver
Suppression du Gestionnaire de pilotes	SQLRemoveDriverManager
Suppression d’un traducteur	SQLRemoveTranslator