OLEDB 调用存储过程

除了常规调用sql语句和进行简单的插入删除操作外,OLEDB还提供了调用存储过程的功能,存储过程就好像是用SQL语句写成的一个函数,可以有参数,有返回值。

存储过程除了像普通函数那样返回一般的值以外,还可以返回结果集,对于返回的内容可以使用输出参数的方式获取,但是如果返回的是结果集,一般不推荐使用输出参数来获取,一般采用的是使用多结果集来接收。另外对于输入参数一般采用参数化查询的方式进行,因此它的使用与参数化查询类似,但是相比于参数化查询来说要复杂一些。

存储过程的使用

对于输出参数,在绑定DBBINDING 结构的时候,将结构的eParamIO指定为DBPARAMIO_OUTPUT,调用存储过程可以使用类似下面的格式

1
{? = call myProc(?, ?)}

这个样式中两个大括号是必须的,其中?代表的输入输出参数,call表示调用存储过程,也是必须的。
一般来说,存储过程的参数位置只接受输入,不作为输出参数,而存储过程的返回值位置只作为输出,不作为输入。另外最需要注意的一点是:当存储过程返回结果集的时候,返回的结果集指针如果没有被释放的话,输出参数的缓冲是不会被刷新的,也就是接收不到输出参数。这是由于数据提供者在返回这些数据的时候是按照流的方式。而结果集的流在输出参数和返回值的流之前,所以在结果集未被释放之前,应用程序是接收不到输出参数的。
针对他的这个特性,我们一般是先使用存储过程返回的结果集,然后释放结果集的相关指针,接着从输出参数的缓冲中取出数据,最后释放这些缓冲。

存储过程使用的例子

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
BOOL ExecUsp(IOpenRowset *pIOpenRowset)
{
IAccessor *pParamAccessor = NULL;

LPOLESTR pSQL = OLESTR("{? = call Usp_InputOutput(?,?)}");
DB_UPARAMS cParams = 0;
DBPARAMINFO* rgParamInfo = NULL;
DBBINDING* rgParamBind = NULL;
LPOLESTR pParamNames = NULL;
DWORD dwOffset = 0;
HACCESSOR hAccessor = NULL;
TCHAR szInputBuffer[11] = _T("");
DBPARAMS dbParams = {0};
BOOL bRet = FALSE;

HRESULT hRes = pIOpenRowset->QueryInterface(IID_IDBCreateCommand, (void**)&pIDBCreateCommand);
hRes = pIDBCreateCommand->CreateCommand(NULL, IID_ICommandText, (IUnknown**)&pICommandText);

hRes = pICommandText->SetCommandText(DBGUID_DEFAULT, pSQL);
hRes = pICommandText->QueryInterface(IID_ICommandPrepare, (void**)&pICommandPrepare);
hRes = pICommandPrepare->Prepare(0);

hRes = pICommandText->QueryInterface(IID_ICommandWithParameters, (void**)&pICommandWithParameters);
hRes = pICommandWithParameters->GetParameterInfo(&cParams, &rgParamInfo, &pParamNames);

//参数绑定
rgParamBind = (DBBINDING*)MALLOC(sizeof(DBBINDING) * cParams);
for (int i = 0; i < cParams; i++)
{
rgParamBind[i].bPrecision = 11;
rgParamBind[i].bScale = rgParamInfo[i].bScale;
rgParamBind[i].cbMaxLen = rgParamInfo[i].ulParamSize; //由于都是int型,所以这里就不需要指定多余的缓冲
rgParamBind[i].iOrdinal = rgParamInfo[i].iOrdinal;
rgParamBind[i].dwPart = DBPART_VALUE;
//当发现参数是输入参数的时候,在eParamIO中加一个输入参数的性质,
if (rgParamInfo[i].dwFlags & DBPARAMFLAGS_ISINPUT)
{
rgParamBind[i].eParamIO |= DBPARAMIO_INPUT;
}

//同上
if (rgParamInfo[i].dwFlags & DBPARAMFLAGS_ISOUTPUT)
{
rgParamBind[i].eParamIO |= DBPARAMIO_OUTPUT;
}

rgParamBind[i].dwMemOwner = DBMEMOWNER_CLIENTOWNED;
rgParamBind[i].obLength = 0;
rgParamBind[i].obStatus = 0;
rgParamBind[i].obValue = dwOffset;
dwOffset = rgParamBind[i].obValue + rgParamBind[i].cbMaxLen;
rgParamBind[i].wType = rgParamInfo[i].wType; //其实他们都是int型
}

//创建参数的访问器
hRes = pICommandText->QueryInterface(IID_IAccessor, (void**)&pParamAccessor);
COM_SUCCESS(hRes, _T("查询接口pParamAccessor失败,错误码为:%08x\n"), hRes);
hRes = pParamAccessor->CreateAccessor(DBACCESSOR_PARAMETERDATA, cParams, rgParamBind, dwOffset, &hAccessor, NULL);
COM_SUCCESS(hRes, _T("创建访问器失败,错误码为:%08x\n"), hRes);

//设置参数值
dbParams.pData = MALLOC(dwOffset);
ZeroMemory(dbParams.pData , dwOffset);
dbParams.cParamSets = cParams;
dbParams.hAccessor = hAccessor;
for (int i = 0; i < cParams; i++)
{
if (rgParamBind[i].eParamIO & DBPARAMIO_INPUT)
{
COM_PRINT(_T("请输入第%d个参数的值[%s]:"), i + 1, rgParamInfo[i].pwszName);
while (S_OK != StringCchGets(szInputBuffer, 11));

*(int*)((BYTE*)dbParams.pData + rgParamBind[i].obValue) = _ttoi(szInputBuffer);
ZeroMemory(szInputBuffer, 11 * sizeof(TCHAR));
}
}

hRes = pICommandText->Execute(NULL, IID_IMultipleResults, &dbParams, NULL, (IUnknown**)&pIMultipleResults);

//读取结果集
ReadRowset(pIMultipleResults);
COM_PRINT(_T("返回值为:%d\n"), *(int*)dbParams.pData)
bRet = TRUE;

__CLEAR_UP:
CoTaskMemFree(rgParamInfo);
FREE(rgParamBind);
CoTaskMemFree(pParamNames);
FREE(dbParams.pData);

SAFE_RELEASE(pIDBCreateCommand);
SAFE_RELEASE(pICommandText);
SAFE_RELEASE(pICommandPrepare);
SAFE_RELEASE(pICommandWithParameters);
SAFE_RELEASE(pParamAccessor);
SAFE_RELEASE(pIMultipleResults);

return bRet;
}

上述代码中调用的存储过程如下:

1
2
3
4
5
6
7
8
9
10
ALTER PROCEDURE [dbo].[Usp_InputOutput]
@input int,
@output int Output

AS
BEGIN
select @input, @output
set @output = 2
return 7
END

该存储过程输入两个参数,并通过select返回有这两个参数组成的结果集。存储过程的输出参数为7.
在上述代码中,先定义了一个调用存储过程的sql语句,接着在ICommandText对象中设置该存储过程,然后获取参数的相关信息,然后绑定参数,提供输出、输出参数的缓冲,然后执行存储过程获取结果集。接着读取结果集。最后读取返回值。
上面我们说过如果不释放返回的结果集的指针的话,是接收不到返回值的,但是在这段代码中好像在读取返回值之前没有释放返回的IMultipleResults指针的操作,但是还是可以取到结果集的,这是为什么呢?其实之前说的是返回的结果集,但是并没有说是多行结果集,这里释放的主要是结果集。针对多行结果集,我们只要释放它里面包含的所有结果集对象就可以了。释放结果集的代码在函数ReadRowset中,这里并没有列举出来。

最后:完整的代码:请点击这里查看