METODE IDWriteLocalizedStrings::GetString (dwrite.h)

Menyalin string dengan indeks yang ditentukan ke array yang ditentukan.

Sintaks

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

Parameter

index

Jenis: UINT32

Indeks berbasis nol dari pasangan bahasa/string yang akan diperiksa.

[out] stringBuffer

Jenis: WCHAR*

Array karakter null yang dihentikan yang menerima string dari pasangan bahasa/string. Buffer yang dialokasikan untuk array ini harus setidaknya berukuran. GetStringLength dapat digunakan untuk mendapatkan ukuran array sebelum menggunakan metode ini.

size

Jenis: UINT32

Ukuran array dalam karakter. Ukuran harus mencakup spasi untuk karakter null yang mengakhiri. GetStringLength dapat digunakan untuk mendapatkan ukuran array sebelum menggunakan metode ini.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

String yang dikembalikan harus dialokasikan oleh pemanggil. Anda bisa mendapatkan ukuran string dengan menggunakan metode GetStringLength sebelum memanggil GetString, seperti yang ditunjukkan dalam contoh berikut.

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);
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	dwrite.h
Pustaka	Dwrite.lib
DLL	Dwrite.dll

Lihat juga

IDWriteLocalizedStrings