winstring.h 标头

此标头由 Windows 运行时C++引用使用。 有关详细信息，请参见:

• Windows 运行时C++参考

winstring.h 包含以下编程接口：

Functions

HSTRING_UserFree HSTRING_UserFree函数（winstring.h）在 RPC 存根文件调用时释放服务器端的资源。
HSTRING_UserMarshal HSTRING_UserMarshal函数 （winstring.h） 将 HSTRING 对象封送到 RPC 缓冲区中。
HSTRING_UserSize HSTRING_UserSize 函数 （winstring.h） 计算 HSTRING 对象的线大小，并检索其句柄和数据。
HSTRING_UserUnmarshal HSTRING_UserUnmarshal函数 （winstring.h） 将 HSTRING 对象从 RPC 缓冲区中解体。
WindowsCompareStringOrdinal 比较两个指定的 HSTRING 对象，并返回一个整数，以排序顺序指示其相对位置。
WindowsConcatString 连接两个指定的字符串。
WindowsCreateString 基于指定的源字符串创建新的 HSTRING。
WindowsCreateStringReference 基于指定的字符串创建新的字符串引用。
WindowsDeleteString 递减字符串缓冲区的引用计数。
WindowsDeleteStringBuffer 如果预先分配的字符串缓冲区未提升为 HSTRING，则放弃该缓冲区。
WindowsDuplicateString 创建指定字符串的副本。
WindowsGetStringLen 获取指定字符串的长度（以 Unicode 字符为单位）。
WindowsGetStringRawBuffer 检索指定字符串的后盾缓冲区。
WindowsInspectString 为调试器提供一种方法，用于在另一个地址空间、远程或转储中显示 Windows 运行时 HSTRING 的值。 （WindowsInspectString）
WindowsInspectString2 为调试器提供一种方法，用于在另一个地址空间、远程或转储中显示 Windows 运行时 HSTRING 的值。 （WindowsInspectString2）
WindowsIsStringEmpty 指示指定的字符串是否为空字符串。
WindowsPreallocateStringBuffer 分配可变字符缓冲区，以便在 HSTRING 创建中使用。
WindowsPromoteStringBuffer 从指定的HSTRING_BUFFER创建 HSTRING。
WindowsReplaceString 将指定字符串中一组字符的所有匹配项替换为另一组字符以创建新字符串。
WindowsStringHasEmbeddedNull 指示指定的字符串是否嵌入了 null 字符。
WindowsSubstring 从指定的字符串中检索子字符串。 子字符串从指定的字符位置开始。
WindowsSubstringWithSpecifiedLength 从指定的字符串中检索子字符串。 子字符串从指定的字符位置开始，并具有指定的长度。
WindowsTrimStringEnd 从源字符串中删除指定字符集的所有尾随匹配项。
WindowsTrimStringStart 从源字符串中删除指定字符集的所有前导匹配项。

回调函数

PINSPECT_HSTRING_CALLBACK 提供指向 WindowsInspectString 函数使用的回调的函数指针。