OLEDB 调用存储过程

---

title: OLEDB 调用存储过程
tags: [OLEDB, 数据库编程, VC++, 数据库]
date: 2018-03-31 14:09:35
categories: windows 数据库编程
keywords: OLEDB, 数据库编程, VC++, 数据库, 存储过程, 输入输出参数

---

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

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

存储过程的使用

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

{? = call myProc(?, ?)}

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

存储过程使用的例子

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;
}

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

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中，这里并没有列举出来。

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

---