Share via


IChangeUnitListFilterInfo::Initialize

Initializes a new instance of the IChangeUnitListFilterInfo class that contains the specified array of change unit IDs.

HRESULT Initialize(
  const BYTE * const * ppbChangeUnitIds,
  DWORD dwChangeUnitCount);

Parameters

  • ppbChangeUnitIds
    [in, size_is(dwChangeUnitCount)] The array of change unit IDs that indicate which change units are included by this filter.
  • dwChangeUnitCount
    [in] The number of change unit IDs that are contained in ppbChangeUnitIds.

Return Value

  • S_OK

  • E_INVALIDARG when dwChangeUnitCount is 0, or if any ID that is contained in ppbChangeUnitIds is not valid.

  • E_OUTOFMEMORY

  • E_POINTER

Remarks

An IChangeUnitListFilterInfo object can be reused. Calling Initialize more than one time frees any previously contained array of change unit IDs and replaces it with the array that is specified by ppbChangeUnitIds.

See Also

Reference

IChangeUnitListFilterInfo Interface