Función SQLInstallDriverManager

Conformidad
Versión introducida: ODBC 1.0: en desuso en Windows XP Service Pack 2, Windows Server 2003 Service Pack 1 y sistemas operativos posteriores

Resumen
SQLInstallDriverManager devuelve la ruta de acceso del directorio de destino para la instalación de los componentes principales de ODBC. El programa de llamada debe copiar realmente los archivos del Administrador de controladores en el directorio de destino.

Sintaxis

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

Argumentos

lpszPath
[Salida] Ruta de acceso del directorio de destino de la instalación.

cbPathMax
[Entrada] Longitud de lpszPath. Debe ser al menos _MAX_PATH bytes.

pcbPathOut
[Salida] Número total de bytes (excepto el byte de terminación NULL) devuelto en lpszPath. Si el número de bytes disponibles para devolver es mayor o igual que cbPathMax, la ruta de acceso de lpszPath se trunca a cbPathMax menos el carácter de terminación null. El argumento pcbPathOut puede ser un puntero nulo.

Devoluciones

La función devuelve TRUE si se realiza correctamente, FALSE si se produce un error.

Diagnóstico

Cuando SQLInstallDriverManager devuelve FALSE, se puede obtener un valor *pfErrorCode asociado llamando a SQLInstallerError. En la tabla siguiente se enumeran los valores *pfErrorCode que SQLInstallerError puede devolver y explica cada uno de ellos en el contexto de esta función.

*pfErrorCode	Error	Descripción
ODBC_ERROR_GENERAL_ERR	Error general del instalador	Se produjo un error para el que no hubo ningún error de instalador específico.
ODBC_ERROR_INVALID_BUFF_LEN	Longitud de búfer no válida	El argumento lpszPath no era lo suficientemente grande como para contener la ruta de acceso de salida. El búfer contiene la ruta de acceso truncada. El argumento cbPathMax era menor que _MAX_PATH.
ODBC_ERROR_USAGE_UPDATE_FAILED	No se pudo incrementar ni disminuir el recuento de uso de componentes	El instalador no pudo incrementar el número de uso de componentes principales de ODBC.
ODBC_ERROR_OUT_OF_MEM	No hay memoria suficiente	El instalador no pudo realizar la función debido a una falta de memoria.

Comentarios

Se llama a SQLInstallDriverManager para devolver la ruta de acceso de los componentes principales de ODBC e incrementar el recuento de uso de componentes en la información del sistema. Si ya existe una versión del Administrador de controladores, pero el recuento de uso de componentes para el controlador no existe, el nuevo valor de recuento de uso de componentes se establece en 2.

El programa de instalación de la aplicación es responsable de copiar físicamente los archivos de componentes principales y mantener los recuentos de uso de archivos. Si no se ha instalado previamente un archivo de componente principal, el programa de instalación de la aplicación debe copiar el archivo y crear el recuento de uso de archivos. Si el archivo se instaló anteriormente, el programa de instalación simplemente incrementa el recuento de uso de archivos.

Si el programa de instalación de la aplicación instaló previamente una versión anterior del Administrador de controladores, los componentes principales deben desinstalarse y volver a instalarse para que el recuento de uso de componentes principales sea válido. Primero se debe llamar a SQLRemoveDriverManager para reducir el número de uso de componentes. A continuación, se debe llamar a SQLInstallDriverManager para incrementar el número de uso de componentes. El programa de instalación de la aplicación debe reemplazar los archivos de componentes principales antiguos por los nuevos archivos. Los recuentos de uso de archivos seguirán siendo los mismos y otras aplicaciones que usaron los archivos de componentes principales de la versión anterior ahora usarán los archivos de versión más recientes.

En una nueva instalación de los componentes principales de ODBC, los controladores y los traductores, el programa de instalación de la aplicación debe llamar a las siguientes funciones en secuencia: SQLInstallDriverManager, SQLInstallDriverEx, SQLConfigDriver (con fRequest de ODBC_INSTALL_DRIVER) y, a continuación, SQLInstallTranslatorEx. En una desinstalación de los componentes principales, controladores y traductores, el programa de instalación de la aplicación debe llamar a las siguientes funciones en secuencia: SQLRemoveTranslator, SQLRemoveDriver y, a continuación, SQLRemoveDriverManager. Estas funciones deben llamarse en esta secuencia. En una actualización de todos los componentes, se debe llamar a todas las funciones de desinstalación en secuencia y, a continuación, se debe llamar a todas las funciones de instalación en secuencia.

Funciones relacionadas

Para información acerca de	Vea
Agregar, modificar o quitar un controlador	SQLConfigDriver
Instalación de un controlador	SQLInstallDriverEx
Instalación de un traductor	SQLInstallTranslatorEx
Eliminación de un controlador	SQLRemoveDriver
Quitar el Administrador de controladores	SQLRemoveDriverManager
Eliminación de un traductor	SQLRemoveTranslator