IDWriteFontCollectionLoader::CreateEnumeratorFromKey method (dwrite.h)

Creates a font file enumerator object that encapsulates a collection of font files. The font system calls back to this interface to create a font collection.

Syntax

HRESULT CreateEnumeratorFromKey(
        IDWriteFactory            *factory,
  [in]  void const                *collectionKey,
        UINT32                    collectionKeySize,
  [out] IDWriteFontFileEnumerator **fontFileEnumerator
);

Parameters

factory

Type: IDWriteFactory*

Pointer to the IDWriteFactory object that was used to create the current font collection.

[in] collectionKey

Type: const void*

A font collection key that uniquely identifies the collection of font files within the scope of the font collection loader being used. The buffer allocated for this key must be at least the size, in bytes, specified by collectionKeySize.

collectionKeySize

Type: UINT32

The size of the font collection key, in bytes.

[out] fontFileEnumerator

Type: IDWriteFontFileEnumerator**

When this method returns, contains the address of a pointer to the newly created font file enumerator.

Return value

Type: HRESULT

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

Requirements

See also

IDWriteFontCollectionLoader