未分类--Windows API--SysAllocString

原文来自MSDN Library for Visual Studio 2008 SP1，翻译部分仅为个人观点，想要看更多信息请看MSDN，如有版权问题请联系QQ 643166601，邮件643166601@qq.com

 

Platform Builder for Microsoft Windows CE 5.0   

SysAllocString

This function allocates a new string and copies the passed string into it.
这个函数申请一个新的字符串并且拷贝传入的字符串到它里面。
This function returns null if there is insufficient memory or if a null pointer is passed in.
如果不足内存或如果一个空指针传入则这个函数返回null。
BSTR SysAllocString(
  OLECHAR FAR* sz
);
Parameters
sz
[in] Null-terminated string to copy.
空结束字符串去拷贝。
The string must be a Unicode string in 32-bit applications, and an ANSI string in 16-bit applications.
这个字符在32位应用程序中必须是Unicode字符串，在16位应用程序中必须是ANSI字符串。
Return Values
Returns the allocated string to indicate success, or NULL to indicate that insufficient memory exists or that the sz parameter was NULL.
返回分配的字符串指示成功，或者用NULL指示内存存在不足或sz参数是NULL。
Remarks
Windows CE supports only Unicode strings.
Windows CE只支持Unicode字符串。
Passing invalid (and under some circumstances NULL) pointers to this function causes an unexpected termination of the application.
传入无效的（在某些情况下NULL）指针到这个函数引起意外的程序终止。
You can free strings created with SysAllocString using SysFreeString.
你可以用 SysFreeString释放SysAllocString创建的字符串。
Requirements
OS Versions: Windows CE 2.0 and later.
Header: Oleauto.h.
Link Library: Oleaut32.lib.

See Also
Automation Functions | SysFreeString

 

--------------------------------------------------------------------------------

Last updated on Wednesday, September 14, 2005

© 2005 Microsoft Corporation. All rights reserved.