Share via


IMessenger::MyContacts property

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

Retrieves the contact list contained in the client or Messenger object. The retrieved list is a MessengerContacts collection object that can be manipulated with the IMessengerContacts interface.

This property is read-only.

Syntax

HRESULT get_MyContacts(
  [out, retval] IDispatch **ppMContacts
);

Property value

Return value. Pointer to a pointer to an IDispatch interface. Returns the IMessengerContacts interface on the contact list or MessengerContacts collection object.

Error codes

Returns one of the following values.

Name Meaning
S_OK
Success. See Remarks.
RPC_X_NULL_REF_POINTER
ppMContacts is a NULL pointer.
E_FAIL
Error during list creation.

Remarks

ppMContacts should be released when it is no longer needed. Retrieved lists can potentially have zero members in their collection. If multiple services are enabled, this method combines the lists of several services.

If this method is called while the client is not signed in, S_OK will still be the HRESULT and a true object will be returned. However, the resulting MessengerContactscollection object will have zero members.

Note

This property is 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