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
S_OK
Success.
RPC_X_NULL_REF_POINTER
pbstrName is a NULL pointer.
E_OUTOFMEMORY
String comparison failed.
E_FAIL
Local user is not logged on.
MSGR_E_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
Msgrua.h
IDL
Msgrua.idl
DLL
Msgsc.dll

See also

IMessengerGroup