IFont::Clone method (ocidl.h)

Article
02/22/2024

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

Syntax

HRESULT Clone(
  [out] IFont **ppFont
);

Parameters

[out] ppFont

Address of IFont pointer variable that receives the interface pointer to the new font object. The caller must call IFont::Release when this new font object is no longer needed.

Return value

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

Return code	Description
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.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	ocidl.h

Share via