Microsoft DirectX 8.1 (C++)

IChannels::get_Item

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The get_Item method retrieves the Channel object at the specified index.

Syntax

HRESULT get_Item(
  VARIANT  varIndex,
  IChannel**  ppVal
);

Parameters

varIndex

[in]  Specifies the item to be retrieved. This must be a VARIANT of subtype VT_I4 containing an index in the range from 0 to the value returned by IChannels::get_Count minus 1.

ppVal

[out]  Address of a variable to receive a pointer to the IChannel interface of the retrieved object.

Return Values

This method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.
E_INVALIDARG varIndex is not a valid type, or does not specify an existing object.
E_POINTER Data cannot be read from or written to a supplied address.

See Also