适用于:Excel 2013 | Office 2013 | Visual Studio
框架库函数。 Excel 是 Excel4 函数的包装器。 Excel12f 是 Excel12 函数的包装器。 每个检查参数是否均不为零,这表示创建临时 XLOPER 或 XLOPER12 失败。 如果发生错误,则每个输出一条调试消息。 完成后,每个内存将释放可能已为临时 XLOPER和 XLOPER12创建的所有临时内存。
从 Excel 2007 C API 库开始,只能从 DLL 调用 Excel 12f。 此外,它仅在从 Excel 2007 开始运行时有效,否则会失败并出现 xlretFailed 。
int Excel(int iFunction, LPXLOPER pxRes, int iCount,
LPXLOPER argument1, ...);
int Excel12f(int iFunction, LPXLOPER12 pxRes, int iCount,
LPXLOPER12 argument1, ...);
参数
iFunction (int)
指示要调用的命令或函数的数字。 有关详细信息,请参阅 Excel4/Excel12。
pxRes
指向已计算函数结果的指针。 结果中指向的任何内存都将由 Excel 分配,在不再需要 xlFree 后,应在调用 xlFree 时释放,或者在将 xlbitXLFree 返回到 Excel 时通过设置 xlbitXLFree 来释放。
iCount (int)
将传递给函数的参数数。 从 Excel 2007 开始,限制为 255 个参数。 在早期版本中,限制为 30。
argument1, ...
函数的可选参数。 对于 Excel,所有参数都必须是指向 XLOPER的指针,或者对于 Excel12f,XLOPER12 。
返回值
这两个函数返回与 Excel4、Excel4v、Excel12 和 Excel12v 相同的错误和成功代码。 有关这些代码的完整说明,请参阅 Excel4/Excel12 。 此外,如果检测到指向参数的 NULL 指针,则这些框架函数返回 xlretFailed 而不调用 C API。
示例
本示例将错误的参数传递给 Excel12f 函数,该函数向调试器发送消息。
\SAMPLES\EXAMPLE\EXAMPLE.C
short WINAPI Excel12fExample(void)
{
Excel12f(xlcDisplay, 0, 1, 0);
return 1;
}