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。