TempStrConst/TempStr12

适用于:Excel 2013 | Office 2013 | Visual Studio

框架库函数,用于创建包含 xltypeStr 字符串的临时 XLOPER/XLOPER12,采用以 null 结尾的源字符串作为输入。 函数分配新的内存缓冲区,并将传入的字符串复制到其中。 输入字符串不会更改,因此声明为 const

LPXLOPER TempStrConst(const LPSTR str);
LPXLOPER12 TempStr12(const XCHAR* lpstr);

参数

str

指向以 null 结尾的源字符串的指针。 对于 XLOPER,TempStrConst将截断长度超过 255 字节的字符串。 对于 XLOPER12,TempStr12Const 将截断超过 32,767 个 Unicode 字符的字符串。

返回值

返回一个 xltypeStr 字符串,其中包含传入字符串缓冲区的副本。

备注

请注意, XLOPER 字符串框架函数 TempStr 的行为不同,并尝试用后续字符串的长度覆盖所提供的字符串的第一个字符。 这并不总是一件安全的事情:如果传递了只读字符串,Microsoft Excel 可能会崩溃。 现在已弃用这种创建临时字符串的方式,而改用 TempStrConstTempStr12 的工作方式。 因此,输入字符串的第一个字符被视为字符串的开头,即不被视为长度字符或长度字符的空格。 不应传递在开头编码长度字符的字符串,因为后果可能是不可预知的。

示例

此示例使用 TempStr12 函数为消息框创建字符串。

\SAMPLES\EXAMPLE\EXAMPLE.C

short WINAPI TempStrExample(void)
{
   Excel12f(xlcAlert, 0, 1, TempStr12Const(L"Made it!"));
   return 1;
}

另请参阅

框架库中的函数