IFont::put_Name

Specifies a new name for the font family.

HRESULT put_Name(
  BSTR name  //Name of the font family
);
 

Parameters

name

[in] New name of the font family. This BSTR value is both allocated and freed by the caller.

Return Values

The method supports the standard return value E_UNEXPECTED, as well as the following:

S_OK

The name was changed successfully.

E_POINTER

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

Remarks

Notes to Callers

The string value is caller allocated and the caller is responsible for freeing it after this call returns.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in ocidl.h.

See Also

IFont::get_Name