IDWriteFont::GetInformationalStrings method (dwrite.h)

Gets a localized strings collection containing the specified informational strings, indexed by locale name.

Syntax

HRESULT GetInformationalStrings(
        DWRITE_INFORMATIONAL_STRING_ID informationalStringID,
  [out] IDWriteLocalizedStrings        **informationalStrings,
  [out] BOOL                           *exists
);

Parameters

informationalStringID

Type: DWRITE_INFORMATIONAL_STRING_ID

A value that identifies the informational string to get. For example, DWRITE_INFORMATIONAL_STRING_DESCRIPTION specifies a string that contains a description of the font.

[out] informationalStrings

Type: IDWriteLocalizedStrings**

When this method returns, contains an address of a pointer to the newly created localized strings object.

[out] exists

Type: BOOL*

When this method returns, TRUE if the font contains the specified string ID; otherwise, FALSE.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If the font does not contain the string specified by informationalStringID, the return value is S_OK but informationalStrings receives a NULL pointer and exists receives the value FALSE.

Requirements

See also

IDWriteFont