STROBJ_bEnum function (winddi.h)

The STROBJ_bEnum function enumerates glyph identities and positions.

Syntax

ENGAPI BOOL STROBJ_bEnum(
  STROBJ    *pstro,
  ULONG     *pc,
  PGLYPHPOS *ppgpos
);

Parameters

pstro

Pointer to the STROBJ structure containing the GLYPHPOS information.

pc

Pointer to the count, returned by GDI, of GLYPHPOS structures.

ppgpos

Pointer to the array in which GDI writes the GLYPHPOS structures.

Return value

The return value is TRUE if more glyphs remain to be enumerated, or FALSE if the enumeration is complete. The return value is DDI_ERROR if the glyphs cannot be enumerated, and an error code is logged.

Remarks

A driver should download only the glyph handles if it caches fonts itself.

The information returned depends on the driver's return value for DrvGetGlyphMode.

Bitmaps or outlines can also be obtained from FONTOBJ structures.

Printer drivers should call STROBJ_bEnumPositionsOnly instead of STROBJ_bEnum if printer hardware provides internal rendering of TrueType fonts.

Requirements

Requirement Value
Minimum supported client Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform Universal
Header winddi.h (include Winddi.h)
Library Win32k.lib
DLL Win32k.sys

See also

DrvGetGlyphMode

FONTOBJ

FONTOBJ_cGetGlyphs

GLYPHPOS

STROBJ

STROBJ_bEnumPositionsOnly

STROBJ_vEnumStart