IFont::Clone

Creates a duplicate font object with a state identical to the current font.

HRESULT Clone(

IFont** ppfont	//Indirect pointer to the new font object
);

Parameters

ppfont

[out] Indirect pointer to the IFont interface on the new font object. The caller must call IFont::Release when this new font object is no longer needed.

Return Values

The method supports the standard return values E_UNEXPECTED and E_OUTOFMEMORY, as well as the following:

S_OK

The new font object was successfully created.

E_NOTIMPL

This font object does not support cloning.

E_POINTER

The address in ppfont is not valid. For example, it may be NULL.

Remarks

Notes to Callers

The new font object is entirely independent of the first. The caller is responsible for releasing this new object when it is no longer needed. This method does not affect the reference count of the font being cloned.