Edit

Share via

IChangeUnitListFilterInfo::Initialize method (winsync.h)

  • Article

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

Syntax

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

Parameters

[in] ppbChangeUnitIds

The array of change unit IDs that indicate which change units are included by this filter.

[in] dwChangeUnitCount

The number of change unit IDs that are contained in ppbChangeUnitIds.

Return value

The possible return codes include, but are not limited to, the values shown in the following table.

Return code Description
S_OK
 The method succeeded.
E_INVALIDARG
 dwChangeUnitCount is 0, or any ID that is contained in ppbChangeUnitIds is not valid.
E_OUTOFMEMORY
E_POINTER
 Invalid 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.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header winsync.h

See also

IChangeUnitListFilterInfo Interface