Метод IDWriteLocalizedStrings::GetString (dwrite.h)

Копирует строку с указанным индексом в указанный массив.

Синтаксис

HRESULT GetString(
        UINT32 index,
  [out] WCHAR  *stringBuffer,
        UINT32 size
);

Параметры

index

Тип: UINT32

Отсчитываемый от нуля индекс пары "язык/строка", которая требуется изучить.

[out] stringBuffer

Тип: WCHAR*

Массив символов, завершающийся нулевым значением, который получает строку из пары "язык/строка". Буфер, выделенный для этого массива, должен быть по крайней мере размером. GetStringLength можно использовать для получения размера массива перед использованием этого метода.

size

Тип: UINT32

Размер массива в символах. Размер должен включать пробел для завершающего символа NULL. GetStringLength можно использовать для получения размера массива перед использованием этого метода.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Возвращаемая строка должна быть выделена вызывающим объектом. Размер строки можно получить с помощью метода GetStringLength перед вызовом Метода GetString, как показано в следующем примере.

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, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	dwrite.h
Библиотека	Dwrite.lib
DLL	Dwrite.dll

См. также раздел

IDWriteLocalizedStrings