IMessenger::MyContacts Property

  • Article

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 World Wide Web link 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.