IDWriteLocalizedStrings::GetStringLength Method

Gets the length in characters (not including the null terminator) of the string with the specified index.

Syntax

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

Parameter

• index
  A zero-based index of the language/string pair.

• length [out]
  The length in characters of the string, not including the null terminator, from the language/string pair.

Rückgabewert

Ist Methode erfolgreich, wird "S_OK" zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Use GetStringLength to get the string length before calling the IDWriteLocalizedStrings::GetString method, as shown in the following code.

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

Anforderungen

Siehe auch

IDWriteLocalizedStrings