OLEDB 调用存储过程

除了常规调用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中，这里并没有列举出来。

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

---