| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The Remove method removes a specified object from the collection.
Syntax
HRESULT Remove(
VARIANT varIndex
);
Parameters
varIndex
[in] Specifies the object to be removed. The vt member must be one of the following values.
| Value | Description |
| VT_UNKNOWN | The ppunkVal member contains an IUnknown interface pointer to the object to be removed. |
| VT_DISPATCH | The ppdispVal member contains an IDispatch interface pointer to the COM object to be removed. |
| VT_I4 | The lVal member contains the index of the COM object to be removed. This value must be in the range from 0 to the value returned by IPrograms::get_Count minus 1. |
Return Values
The 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 VARIANT subtype, or does not specify an existing object. |
Remarks
Removed objects are permanently deleted from the repository.
See Also