如何实现 SQL Server 2000 桌面引擎回调函数和示例

文章翻译 文章翻译
文章编号: 315463 - 查看本文应用于的产品
本文已归档。它按“原样”提供,并且不再更新。
展开全部 | 关闭全部

本文内容

概要

本文介绍了如何实现回调函数 SQL Server 2000 桌面引擎 (MSDE 2000) 的安装过程中,还讨论了以确保正确地运行回调函数,必须满足所有条件。

SQL Server 2000 桌面引擎 (MSDE 2000) 是在 Microsoft SQL Server 2000 关系数据库引擎的可再发行版本。它允许应用程序安装过程的一部分安装引擎使用 SQL Server 关系数据库引擎的应用程序。

MSDE 2000 安装程序包允许您跟踪进度,或执行自定义操作在安装过程中使用回调函数。

对于使用的回调函数的条件

为正常运行该回调功能,必须满足以下条件:
  • 您必须实现回调函数作为一个 Windows 安装程序自定义操作类型 1 动态链接库 (DLL)。例如对于可以使用 Microsoft Visual c + + 扩展存储过程向导创建回调 DLL。

    有关 Windows 安装程序库类型的详细信息,请访问下面的 Microsoft 开发人员网络 (MSDN) 的网站:
    http://msdn.microsoft.com/library/en-us/msi/cact_6a05.asp?frame=true
  • 回调函数必须位于以下文件夹的任何一个:
    • 返回该文件夹由 GetTempPath Win32 调用。
    • {Product code} 所在的文件夹,将返回位于文件夹中,由 GetTempPath Win32 调用。

      注意{Product code} 是您的计算机上安装的 MSDE 2000 实例的产品代码的占位符。
    通常,则返回该文件夹由 GetTempPath Win32 调用是在 %tmp% 环境变量。如果无法使用 %tmp% 环境变量是 %temp% 环境变量。

    有关 GetTempPath Win32 函数的详细信息,请访问下面的 Microsoft 开发人员网络 (MSDN) 的网站:
    http://msdn.microsoft.com/library/en-us/fileio/base/gettemppath.asp

  • 桌面引擎回调函数必须采取一个包含桌面引擎的退出代码的附加 UINT 参数或返回代码。 回调函数的定义看起来类似于
    UINT __stdcall MyCallbackFunction(MSIHANDLE hinstall, UINT uExitCode)
    						
    uExitCode 其中包含桌面引擎安装程序退出代码,或返回代码。

示例步骤和代码实现回调函数

使用 Microsoft Visual Studio 6.0,以下步骤描述的示例的回调函数的实现。

  1. 在 Microsoft Visual c + + 6.0 IDE 中,单击 文件,然后单击 新建。在 项目 选项卡上单击扩展存储过程向导。
  2. 指定项目名称。例如,MyCallback。您还可以指定您要在其中创建项目的位置。单击 确定
  3. 指定的回调函数的名称。例如,MyCallbackFunction。请注意该示例创建一个回调 DLL 使用扩展存储过程向导。向导建议您指定一个以"XP_"开头的名称。但是,您可以忽略该建议,并指定您选择的回调函数的名称。单击 完成
  4. 这将创建类和所需的 cpp 文件。在工作区窗格中,您将看到此项目的工作区。选择 ClassView 中,然后展开 MyCallback 类 树中的 全局 文件夹。您将看到 MyCallbackFunction 函数的定义。

    下面的 示例代码 标题中的回调函数的代码示例。您可以通过将下面的代码复制到 MyCallbackFunction 函数测试项目。

    示例代码

    #include <stdafx.h>
    
    #define XP_NOERROR 0
    #define XP_ERROR 1
    #define MAXCOLNAME 25
    #define MAXNAME 25
    #define MAXTEXT 255
    
    #ifdef __cplusplus
    extern "C" {
    #endif
    
    UINT __declspec(dllexport) MyCallbackFunction(HANDLE hinstall, UINT uExitCode);
    
    #ifdef __cplusplus
    }
    #endif
    
    UINT __declspec(dllexport) MyCallbackFunction(HANDLE hinstall, UINT uExitCode)
    {
    
         TCHAR buffer[1024];
    
         wsprintf(buffer, TEXT("**Callback** Return code is %d"), uExitCode);
    
         MessageBox(NULL, buffer, TEXT("MyCallbackFunction Dialog"), MB_OK);
    
         return 0;
    }
    					
    此回调函数的示例显示一个消息框,其中具有此文本在每次调用:
    **Callback** Return code is 0
    					
  5. 使用 生成 菜单建立 MyCallback.dll 文件。生成 DLL 和将其保存到名为 调试,在相同的位置,您在步骤 2 中指定的子文件夹。
  6. 在生成 DLL 后,您必须将 DLL 复制到取决于您的计算机安装的 MSDE 2000 版本的一个位置。
    • 如果使用的 Microsoft SQL Server 2000 桌面引擎 SP2,您必须将 DLL 复制到由下列环境变量的一个定义的位置上:
      • %tmp%
      • %
      若要获取环境变量的值为当前登录的用户在特定计算机上,请在命令提示符处键入以下命令:
      SET
      该命令将显示所有环境变量,包括 TMP温度
    • 如果使用的 Microsoft SQL Server 2000 桌面引擎 SP3a 您必须将 DLL 复制到下列位置之一:
      • %TMP%\ {Product code}
      • %TEMP%\ {Product code}
      注意{Product code} 是占位符,您的计算机上安装的 MSDE 2000 实例的产品代码。

      例如,如果 MSDE 2000 实例中有一个产品代码的 E09B48B5-E141-427A-AB0C-D3605127224A 必须复制到 DLL 在 %TMP%\{E09B48B5-E141-427A-AB0C-D3605127224A}%TEMP%\{E09B48B5-E141-427A-AB0C-D3605127224A} 文件夹。
  7. 使用桌面引擎 Windows 安装程序回调选项在安装过程中调用回调函数。例如:
    CALLBACK=Dllname!CallbackFunctionName
    语法是本示例为:
    setup.exe /L*v c:\msde_setup.log CALLBACK=MyCallback!MyCallbackFunction
    					

参考

有关更多的信息请单击下面的文章编号,以查看 Microsoft 知识库中相应的文章:
299795如何编写使用 Microsoft Visual Studio 安装 1.1 的 MSDE 2000 安装程序程序包


Windows 安装程序 SDK 是部分的在 Microsoft 平台软件开发工具包 (SDK)。有关平台 SDK 的详细信息,请访问下面的 Microsoft 网站:
http://www.microsoft.com/msdownload/platformsdk/sdkupdate/
SQL Server 2000 丛书联机 ; 主题:"构建 SQL Server 应用程序"、"分发 SQL Server 应用程序"、"分发 SQL Server 与应用";"桌面引擎 Windows 安装程序返回代码"、"桌面引擎 Windows 安装程序回调函数"

属性

文章编号: 315463 - 最后修改: 2013年10月24日 - 修订: 3.0
这篇文章中的信息适用于:
  • Microsoft SQL Server 2000 Desktop Engine (MSDE) SP3a
  • Microsoft SQL Server 2000 Desktop Engine (Windows)
关键字:?
kbnosurvey kbarchive kbmt kbhowtomaster KB315463 KbMtzh
机器翻译
注意:这篇文章是由无人工介入的微软自动的机器翻译软件翻译完成。微软很高兴能同时提供给您由人工翻译的和由机器翻译的文章, 以使您能使用您的语言访问所有的知识库文章。然而由机器翻译的文章并不总是完美的。它可能存在词汇,语法或文法的问题,就像是一个外国人在说中文时总是可能犯这样的错误。虽然我们经常升级机器翻译软件以提高翻译质量,但是我们不保证机器翻译的正确度,也不对由于内容的误译或者客户对它的错误使用所引起的任何直接的, 或间接的可能的问题负责。
点击这里察看该文章的英文版: 315463
Microsoft和/或其各供应商对于为任何目的而在本服务器上发布的文件及有关图形所含信息的适用性,不作任何声明。 所有该等文件及有关图形均"依样"提供,而不带任何性质的保证。Microsoft和/或其各供应商特此声明,对所有与该等信息有关的保证和条件不负任何责任,该等保证和条件包括关于适销性、符合特定用途、所有权和非侵权的所有默示保证和条件。在任何情况下,在由于使用或运行本服务器上的信息所引起的或与该等使用或运行有关的诉讼中,Microsoft和/或其各供应商就因丧失使用、数据或利润所导致的任何特别的、间接的、衍生性的损害或任何因使用而丧失所导致的之损害、数据或利润不负任何责任。

提供反馈

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com