IChangeUnitListFilterInfo::GetChangeUnitId
取得變更單位識別碼,這個識別碼會儲存在定義篩選之變更單位識別碼陣列的指定之索引中。
HRESULT GetChangeUnitId(
DWORD dwChangeUnitIdIndex,
BYTE * pbChangeUnitId,
DWORD * pcbIdSize);
參數
- dwChangeUnitIdIndex
[in] 要查閱之變更單位識別碼的索引。
- pbChangeUnitId
[in, out, unique, size_is(*pcbIdSize)] 傳回儲存在 dwChangeUnitIdIndex 指定之索引的變更單位識別碼。
- pcbIdSize
[in, out] 指定 pbChangeUnitId 中的位元組數目。如果 pbChangeUnitId 太小,就傳回擷取此識別碼所需的位元組數目,或寫入的位元組數目。
傳回值
S_OK
如果未定義篩選,或者 dwChangeUnitIdIndex 大於定義篩選的變更單位識別碼數目,則為 E_INVALIDARG。
E_POINTER
當 pbChangeUnitId 太小時,為 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在這種情況下,所需的位元組數目是在 pcbIdSize 中傳回。
如果要傳回的變更單位識別碼無效,則為 SYNC_E_ID_FORMAT_MISMATCH。