IMessenger::MyContacts Property
Deprecated. 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.
Syntax
HRESULT IMessenger::get_MyContacts(IDispatch **ppMContacts);
Parameters
- ppMContacts
Return value. Pointer to a pointer to an IDispatch interface. Returns the IMessengerContacts interface on the contact list or MessengerContacts collection object.
Return Value
Returns one of the following values:
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.
Important IMessenger::MyContacts is no longer available in Windows Vista. See Windows Messenger for more information.