设计Microsoft Windows NT操作系统上的32位SQL Serv

设计Microsoft Windows NT操作系统上的32位SQL Server 应用程序

Christopher Moffatt
Microsoft Technical Resources Group

摘要

Microsoft® Windows NT™操作系统是建立充满活力、功能丰富的Microsoft SQL Server应用程序的一个完美的平台。SQL Server Programmer's Toolkit for Windows NT（SQL Server 程序员Windows NT工具包）含有DB-Library™的32位(Win32™ API)版本，使得开发Windows NT操作系统上的用于Microsoft SQL Server的DB-Library客户端程序成为可能。

这篇技术文章用于将DB-Library开发人员引入到Microsoft Windows NT平台上，讨论的问题包括将已有的Windows™ 3.x和OS/2®操作系统平台上的DB-Library应用程序转换到Windows NT操作系统，并对DB-Library应用程序如何利用Win32应用程序编程接口(API，application programming interface)的一些方法进行了概要说明。

本篇技术文章假定你已熟悉DB-Library API、C语言编程以及下列内容:

· Microsoft SQL Server Programmer's Reference for C

· Microsoft Win32 API Programmer's Reference, 第1、2卷

· Converting OS/2 Applications to Windows

建立基于Win32的DB-Library应用程序

下面的章节描述了有关使用Microsoft® Win32™应用程序编程接口(API，Application Programming Interface)建立DB-Library™应用程序的应用。

Win32 DB-Library体系结构

在内部机制上，Win32的DB-Library动态链接库(DLL，dynamic-link library)与OS/2®上的实现方式类似。与在OS/2的一样，在Win32中一个独立的操作系统线程（thread）处理每次DB-Library所发出的与SQL Server的联接。通过调用一个进程（process）所装入的每个DB-Library DLL实例（instance）在共享代码的同时得到了一个私有数据区。

Win32 DB-Library体系结构与在Microsoft Windows™ 3. x中的实现方式不同。在Windows 3.x中，DB-Library DLL只有一个被所有调用的进程共享的数据段。W3DBLIB.DLL通过对单一数据段的联接的一个链接式列表维护DB-Library联接。这种体系结构是需要的，因为在Windows 3.x动态链接库只有一个被所有调用进程共享的数据段。这样就必须通过调用dbinit和dbwinexit函数初始化和清除DB-Library DLL数据结构。

库

Win32的DB-Library函数包含于NTWDBLIB.DLL中，而命名管道（named pipe）驱动程序包含在DBNMPNTW.DLL中。应设置PATH环境变量包含这些动态链接库所在的目录。

另一个文件，NTWDBLIB.LIB，包含了你的应用程序使用Win32 API的引入（import）定义。应设置LIB环境变量包含NTWDBLIB.LIB所在的目录。

包含文件

SQL Server Programmer's Toolkit for Windows NT™提供了下列包含文件:

包含文件
内容

SQLFRONT.H
错误代码和严重级（severity levels），混合定义（miscellaneous definitions），和类型定义。

SQLDB.H
所有DB-Library函数的函数原型

你可以在INCLUDE环境变量中添加路径，包含这些包含文件所在的目录。或者你也可以使用/I编译行开关指向包含文件所在的目录。

因为你的使用Win32 API的应用程序必须包含SQLDB.H文件，所以你不需要定义所使用的DB-Library函数。这些函数和它们的正确定义已包含在该包含文件中。你必须在包含DB-Library 包含文件之前定义一个应用程序的操作系统。在所有使用Win32 API设计的DB-Library应用程序的开头包含下列语句；

#define DBNTWIN32

#include <sqlfront.h>

#include <sqldb.h>

你还能通过使用/D编译行参数定义操作系统(例如，使用/DDBNTWIN32 而不是通过一个#define定义)。

编译和链接

下面的例程显示了一个简单的build文件。该文件使用NMAKE工具编译和链接可调试的使用Win32 API的DB-Library应用程序：

NTLIB=\nt\sdk\lib\i386

DBLIB=\sql\dblib\lib

guilibs= $(NTLIB)\gdi32.lib $(NTLIB)\user32.lib $(NTLIB)\

userrtl.lib $(NTLIB)\kernel32.lib $(NTLIB)\ntdll.lib \

$(NTLIB)\libcmt.lib

all: sqltestw.exe

# Update the object file if necessary.

sqltestw.obj: sqltestw.c sqltestw.h sqltestw.rc makefile

cl386 -c -G3d -Di386=1 -DWIN32 sqltest.c

# Update the resource file if necessary.

sqltestw.res: sqltestw.rc sqltestw.h dilaogs.h dialogs.dlg makefile

rc -r -fo sqltestw.tmp sqltest.rc

cvtres -i386 sqltestw.tmp -O sqltestw.res

del sqltestw.tmp

# Update the exe file if necessary.

sqltestw.exe: sql.obj sqltestw.obj sqltestw.res makefile

link -machine:i386 -subsystem:windows -out:sqltestw.exe\

-entry:WinMainCRTStartup\

sqltestw.res sqltestw.obj $(guilibs)\

($DBLIB)\ntwdblib.lib

将基于Windows 3.x的DB-Library应用程序转换到Win32环境

所有的DB-Library函数都完全能够在平台间转换。你不需要更改你的任何DB-Library调用。你仅仅需要在编译时定义应用程序的操作系统(例如, 对于Windows NT为#define DBNTWIN32)。

因为Win32 API保持了与Windows 3.x操作系统的兼容性，所以Win32 DB-Library DLL支持所有基于Windows 3.x的DB-Library函数，即使这些函数不需要也是如此。在Windows 3.x出现而在Windows NT中并不需要的DB-Library函数(例如，DBLOCKLIB和DBUNLOCKLIB)可以被使用，但不执行任何操作。

两个DB-Library函数，dbprhead和dbprrow，由于发送输出到STDIO而在Windows 3.x并不被支持，但在Win32中它们能够被支持并用于开发CONSOLE子系统应用程序。dbprhead和dbprrow函数提供了一种简便的方式将查询结果显示到默认输出设备。

如果你希望使已有的基于Windows的DB-Library应用程序能够在Windows NT上运行，你可以采取三种方法:

· 将你的16位Windows 3.x应用程序不加改变的运行于Windows 3.x子系统. 如果你已有Windows 3.x应用程序，你完全不必甚至将来也不需要进行改动，只需要不加改变的运行即可。

· 更改你的应用程序源代码以便其能被编译用于Win32 API或Windows 3.x. 如果你的DB-Library应用程序正在开发或正在改进以满足不断改变的用户需要，以及你希望在Windows 3.x和Windows NT上运行应用程序，从相同的源代码略微进行改动以建立你的16位(Windows 3.x)版本和32位(Win32)版本的应用程序。

· 将你的应用程序源代码完全转换到Win32. 如果你决定更改你的应用程序只作为32位 (基于Win32)应用程序运行（例如，你需要诸如线程和抢先多任务（preemptive multitasking）等Win32特性），你可以将你的应用程序转换到Win32 API上，并删除冗余的Windows 3.x调用和依赖。

在保持DB-Library对Windows 3.x兼容基础上进行转换

本章节解释了如何将用于Windows 3.x的DB-Library应用程序转换到Windows NT操作系统，而同时保持与Windows 3.x应用程序的兼容性。

用于Windows 3.x和C运行时态的API调用

一般而言，你可以改变你的代码轻而易举地建立16位或32位版的应用程序。对于更深入的讨论编写使用Win32 API的且保留了与Windows 3.x兼容性的应用程序，请参阅Microsoft Win32 API Programmer's Reference第1卷

下面是使用Win32 API的应用程序开发指导方针：

· 函数定义与原型.确保你的函数定义和函数原型使用了可转换的数据类型。

· Windows 消息参数封装.处理扩宽到32位意味着处理的封装、其它wParam和lParam中的值已经改变。检验你是否需要改变你的应用程序中的wParam和lParam编码。

DB-Library函数和数据类型

所有的DB-Library函数都完全能在操作系统间转换。你只需要在编译的时候定义目标操作系统即可。

许多DB-Library函数的返回值为int型。要注意int数据类型在Windows 3.x中是16位值而在Win32 API中则是32位值。因此，对你的应用程序进行检查以使用正确的变量类型接收返回int数据类型的DB-Library函数所返回的值。例如，一个定义为short数据类型的变量在Windows 3.x中可以从DB-Library接收到正确的int值而在Win32 API中则接收到错误的值。

除了检验接收DB-Library的返回值的变量类型是正确的以外，不需要对DB-Library函数做任何改动。

转换的其它考虑

如果你要将Windows 3.x操作系统的一个应用程序转换到Windows NT操作系统上而不需要保持与Windows 3.x的兼容性，你可以改变你的DB-Library代码，删除冗余或不必要的Windows 3.x函数。

冗余的Windows 3.x专用DB-Library函数