IFont::Clone メソッド (ocidl.h)

現在のフォントと同じ状態の重複するフォントオブジェクトを作成します。

構文

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

[out] ppFont

新しいフォントオブジェクトへのインターフェイスポインターを受け取る IFont ポインター変数のアドレス。この新しいフォントオブジェクトが不要になった場合、呼び出し元は IFont::Release を呼び出す必要があります。

メソッドは、E_UNEXPECTEDおよびE_OUTOFMEMORYの標準戻り値と、次の値をサポートしています。

リターンコード	説明
S_OK	新しいフォントオブジェクトが正常に作成されました。
E_NOTIMPL	このフォントオブジェクトは複製をサポートしていません。
E_POINTER	ppfont のアドレスが無効です。たとえば、 NULL にすることができます。

新しいフォントオブジェクトは、最初のフォントオブジェクトから完全に独立しています。呼び出し元は、不要になったこの新しいオブジェクトを解放する必要があります。このメソッドは、複製されるフォントの参照カウントには影響しません。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	ocidl.h