IMessenger2::ContactsSortOrder property

Article
05/31/2018

[ContactsSortOrder is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

Sets or retrieves the current sort order for the local client, which is used to determine if the contacts should be sorted by groups or by their online/offline status.

This property is read/write.

Syntax

HRESULT put_ContactsSortOrder(
  [in]          MUASORT Sort
);

HRESULT get_ContactsSortOrder(
  [out, retval] MUASORT *pSort
);

Property value

Error codes

Returns one of the following values.

Name	Meaning
S_OK	Success.
E_INVALIDARG	MUASORT is out of range.
E_FAIL	The Messenger application window is closed.
MSGR_E_NOT_LOGGED_ON	The local client is not logged on.
MSGR_E_GROUPS_NOT_ENABLED	Groups are not supported.
RPC_X_NULL_REF_POINTER	pSort is a NULL pointer.

Remarks

Some services, such as Microsoft Exchange Instant Messaging Service (IM), do not support groups. The use of this property on these services will return the error MSGR_E_GROUPS_NOT_ENABLED.

Note

The following remarks apply to scripting languages. The get_ContactsSort property is available for scripting languages; put_ContactsSort is not.

Requirements


End of client support	Windows XP
End of server support	Windows Server 2003
Header	Msgrua.h
IDL	Msgrua.idl
DLL	Msgsc.dll

Share via