IMessenger::MyStatus property

[IMessenger::MyStatus is no longer available for use as of Windows Vista. For more information, see Windows Messenger.]

Service status. Use MyStatus instead. To return a list of MessengerService objects, use the Services property.

This property is read/write.

Syntax

HRESULT put_MyStatus(
  [in]          MISTATUS pmiStatus
);

HRESULT get_MyStatus(
  [out, retval] MISTATUS *pmiStatus
);

Property value

Error codes

Returns one of the following values.

Remarks

If the local client is offline, this property returns without attempting to connect. Otherwise, this property will always query the server for the client's local state; it will not use locally stored information.

When multiple clients are registered, get_MyStatus returns the status of the primary client at the time of the call. put_MyStatus sets the status for all the services that each registered client is signed into to the status passed in pmiStatus. The HRESULT returned is from the primary client.

Requirements

See also

IMessenger

MyStatus