IFont::put_Name method (ocidl.h)

Specifies a new name for the font family.

Syntax

HRESULT put_Name(
  [in] BSTR name
);

Parameters

[in] name

The new name of the font family. This value is both allocated and freed by the caller.

Return value

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

Return code Description
S_OK
The name was changed successfully.
E_POINTER
The address in the name parameter 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

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

See also

IFont

IFont::get_Name