Share via


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.

Name Meaning
S_OK
Success.
RPC_X_NULL_REF_POINTER
pmiStatus is a NULL pointer.

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.

Note

The get_MyStatus property is available for scripting languages; put_MyStatus is not.

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
End of client support
Windows XP
End of server support
Windows Server 2003
Header
Msgrua.h
IDL
Msgrua.idl
DLL
Msgsc.dll

See also

IMessenger

MyStatus