IDWriteLocalizedStrings::GetStringLength-Methode (dwrite.h)

Ruft die Länge der Zeichenfolge mit dem angegebenen Index in Zeichen (ohne NULL-Abschlusszeichen) ab.

Syntax

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

Parameter

index

Typ: UINT32

Ein nullbasierter Index des Sprach-/Zeichenfolgenpaars.

[out] length

Typ: UINT32*

Die Länge in Zeichen der Zeichenfolge, ohne den NULL-Abschlusszeichen, aus dem Sprach-/Zeichenfolgenpaar.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Verwenden Sie GetStringLength , um die Zeichenfolgenlänge abzurufen, bevor Sie die IDWriteLocalizedStrings::GetString-Methode aufrufen, wie im folgenden Code gezeigt.

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

Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	dwrite.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteLocalizedStrings