IChangeUnitListFilterInfo::GetChangeUnitId

获取定义筛选器的变更单位 ID 数组中的指定索引处存储的变更单位 ID。

HRESULT GetChangeUnitId(
  DWORD dwChangeUnitIdIndex,
  BYTE * pbChangeUnitId,
  DWORD * pcbIdSize);

参数

  • dwChangeUnitIdIndex
    [in] 要查找的变更单位 ID 的索引。
  • pbChangeUnitId
    [in, out, unique, size_is(*pcbIdSize)] 返回存储在由 dwChangeUnitIdIndex 指定的索引中的变更单位 ID。
  • pcbIdSize
    [in, out] 指定 pbChangeUnitId 中的字节数。如果 pbChangeUnitId 太小,则返回检索 ID 所需的字节数;否则返回写入的字节数。

返回值

  • S_OK

  • 如果未定义筛选器或 dwChangeUnitIdIndex 大于定义筛选器的变更单位 ID 的数目,则返回值为 E_INVALIDARG。

  • E_POINTER

  • 如果 pbChangeUnitId 太小,则返回值为 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在此情况下,将在 pcbIdSize 中返回必需的字节数。

  • 如果要返回的变更单位 ID 无效,则返回值为 SYNC_E_ID_FORMAT_MISMATCH。

请参阅

参考

IChangeUnitListFilterInfo 接口