Export (0) Print
Expand All

IMessenger::MyContacts Property

[MyContacts is no longer available in 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 (get)

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

Parameters

ppMContacts [out]

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:

Return codeDescription
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

Header

Msgrua.h

IDL

Msgrua.idl

DLL

Msgsc.dll

See Also

IMessenger

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010

Community Additions

ADD
Show:
© 2015 Microsoft