IMessengerGroup::Name property
[Name is no longer available for use as of Windows Vista. See Windows Messenger for more information.]
Sets or retrieves
the name of the group.
This property is read/write.
Syntax
HRESULT put_Name(
BSTR bstrName
);
HRESULT get_Name(
[out, retval] BSTR *bstrName
);
Property value
Error codes
Returns one of the following values.
| Name | Meaning |
|---|---|
|
Success. |
|
pbstrName is a NULL pointer. |
|
String comparison failed. |
|
Local user is not logged on. |
|
Client is offline. |
Remarks
The following table lists the error codes returned by this property.
| Error Code | Meaning |
|---|---|
| 0x80004005 | Local user is not logged on. |
| 0x8007000E | String comparison failed. |
| MSGR_E_NOT_LOGGED_ON | Client is offline. |
| MSGR_E_GROUPS_NOT_ENABLED | The current service does not support groups. |
| MSGR_E_GROUP_DOES_NOT_EXIST | The group to be renamed does not exist. |
| MSGR_E_GROUP_NAME_TOO_LONG | The new name of the group exceeds the maximum number of characters. |
| MSGR_E_BAD_GROUP_NAME | The new name of the group is invalid. |
| MSGR_E_CANNOT_RENAME | The group "Other Contacts" is read-only and cannot be renamed. |
Note
This property is not available for scripting languages.
Requirements
| End of client support |
Windows XP |
| End of server support |
Windows Server 2003 |
| Header |
|
| IDL |
|
| DLL |
|