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 |
---|---|
|
Success. See Remarks. |
|
ppMContacts is a NULL pointer. |
|
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 |
|
IDL |
|
DLL |
|