Share via


IMessengerGroups::Item method

[Item is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

Retrieves a specific MessengerGroup object by numeric index.

Syntax

HRESULT Item(
  [in]          long      Index,
  [out, retval] IDispatch **ppService
);

Parameters

Index [in]

Type: long

LONG that specifies the index of the desired MessengerGroup object in the collection.

ppService [out, retval]

Type: IDispatch**

Address of a pointer to the IDispatch interface on a MessengerGroup object requested with IDispatch interface on a Index. The object can now be accessed through the IMessengerGroups interface.

Return value

Type: HRESULT

Returns one of the following values.

Return code Description
S_OK
Success
E_FAIL
Invalid collection or index number provided exceeds the length of the collection.
RPC_X_NULL_REF_POINTER
ppMGroup is a NULL pointer.
E_INVALIDARG
Index is not a positive integer.

Remarks

Note

This method is available for scripting languages.

Requirements

End of client support
Windows XP
End of server support
Windows Server 2003
Header
Msgrua.h
IDL
Msgrua.idl
DLL
Msgsc.dll

See also

IMessengerGroups