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

注意:这篇文章是由无人工介入的微软自动的机器翻译软件翻译完成。微软很高兴能同时提供给您由人工翻译的和由机器翻译的文章, 以使您能使用您的语言访问所有的知识库文章。然而由机器翻译的文章并不总是完美的。它可能存在词汇,语法或文法的问题,就像是一个外国人在说中文时总是可能犯这样的错误。虽然我们经常升级机器翻译软件以提高翻译质量,但是我们不保证机器翻译的正确度,也不对由于内容的误译或者客户对它的错误使用所引起的任何直接的, 或间接的可能的问题负责。

点击这里察看该文章的英文版: 315463
本文已归档。它按“原样”提供,并且不再更新。
概要
本文介绍了如何实现回调函数 SQL Server 2000 桌面引擎 (MSDE 2000) 的安装过程中,还讨论了以确保正确地运行回调函数,必须满足所有条件。

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

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

back to the top

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

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

    有关 Windows 安装程序库类型的详细信息,请访问下面的 Microsoft 开发人员网络 (MSDN) 的网站:
  • 回调函数必须位于以下文件夹的任何一个:
    • 返回该文件夹由 GetTempPath Win32 调用。
    • {Product code} 所在的文件夹,将返回位于文件夹中,由 GetTempPath Win32 调用。

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

    有关 GetTempPath Win32 函数的详细信息,请访问下面的 Microsoft 开发人员网络 (MSDN) 的网站:
  • 桌面引擎回调函数必须采取一个包含桌面引擎的退出代码的附加 UINT 参数或返回代码。 回调函数的定义看起来类似于
    UINT __stdcall MyCallbackFunction(MSIHANDLE hinstall, UINT uExitCode)						
    uExitCode 其中包含桌面引擎安装程序退出代码,或返回代码。

back to the top

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

使用 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 __cplusplusextern "C" {#endifUINT __declspec(dllexport) MyCallbackFunction(HANDLE hinstall, UINT uExitCode);#ifdef __cplusplus}#endifUINT __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					

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


Windows 安装程序 SDK 是部分的在 Microsoft 平台软件开发工具包 (SDK)。有关平台 SDK 的详细信息,请访问下面的 Microsoft 网站:SQL Server 2000 丛书联机 ; 主题:"构建 SQL Server 应用程序"、"分发 SQL Server 应用程序"、"分发 SQL Server 与应用";"桌面引擎 Windows 安装程序返回代码"、"桌面引擎 Windows 安装程序回调函数"
back to the top
MSDE 回调函数 uExitCode kbAudDeveloper kbSQLServ2000Search kbZNotKeyword5 kbSQLServSearch

警告:本文已自动翻译

属性

文章 ID:315463 - 上次审阅时间:10/24/2013 09:11:29 - 修订版本: 3.0

Microsoft SQL Server 2000 Desktop Engine (MSDE) SP3a, Microsoft SQL Server 2000 Desktop Engine (Windows)

  • kbnosurvey kbarchive kbmt kbhowtomaster KB315463 KbMtzh
反馈