IDWriteLocalizedStrings::GetStringLength 方法 (dwrite.h)

获取长度(以字符为单位) (不包括具有指定索引的字符串的 null 终止符) 。

语法

HRESULT GetStringLength(
        UINT32 index,
  [out] UINT32 *length
);

参数

index

类型: UINT32

语言/字符串对的从零开始的索引。

[out] length

类型: UINT32*

语言/字符串对中的字符串(不包括 null 终止符)的长度(以字符为单位)。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

备注

在调用 IDWriteLocalizedStrings::GetString 方法之前,使用 GetStringLength 获取字符串长度,如以下代码所示。

UINT32 length = 0;

// Get the string length.
if (SUCCEEDED(hr))
{
    hr = pFamilyNames->GetStringLength(index, &length);
}

// Allocate a string big enough to hold the name.
wchar_t* name = new (std::nothrow) wchar_t[length+1];
if (name == NULL)
{
    hr = E_OUTOFMEMORY;
}

// Get the family name.
if (SUCCEEDED(hr))
{
    hr = pFamilyNames->GetString(index, name, length+1);
}

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 dwrite.h
Library Dwrite.lib
DLL Dwrite.dll

另请参阅

IDWriteLocalizedStrings