IChangeUnitListFilterInfo::Initialize method (winsync.h)

Article
10/13/2021

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

Share via