Share via

IMessengerContacts::_NewEnum Property

  • Article

Deprecated. Enumerates the MessengerContact objects in a collection.

Syntax

HRESULT IMessengerContacts::get__NewEnum(IUnknown **ppUnknown);

Parameters

  • ppUnknown
    Return value. Address of a pointer to the IUnknown interface on the copy.

Return Value

Returns one of the following values. 

S_OK Success.
RPC_X_NULL_REF_POINTER ppUnknown is a NULL pointer.
E_OUTOFMEMORY Failed during copy.

Remarks

IMessengerContacts::_NewEnum returns a copy of the current collection object. It is a standard method in any collection object. This avoids problems if multiple users are accessing the same remote object and assures that objects in the collections will not change during a traverse of the list.

If this method is called while the client is offline, the returned object is a working copy from an object perspective. However, if the copy is obtained while the client is offline, the contact list will always have zero members and zero count. This should be avoided.

Note  This property is available for scripting languages.

Important  IMessengerContacts::_NewEnum is no longer available in Windows Vista. See Windows Messenger for more information.

See Also

IMessengerContacts