IChangeUnitListFilterInfo::GetChangeUnitId
Obtém a ID da unidade de alteração armazenada no índice especificado na matriz de IDs de unidade de alteração que definem o filtro.
HRESULT GetChangeUnitId(
DWORD dwChangeUnitIdIndex,
BYTE * pbChangeUnitId,
DWORD * pcbIdSize);
Parâmetros
- dwChangeUnitIdIndex
[in] O índice da ID de unidade de alteração a ser procurada.
- pbChangeUnitId
[in, out, unique, size_is(*pcbIdSize)] Retorna a ID da unidade de alteração armazenada no índice especificado por dwChangeUnitIdIndex.
- pcbIdSize
[in, out] Especifica o número de bytes em pbChangeUnitId. Retorna o número de bytes necessários para recuperar a ID quando pbChangeUnitId é muito pequeno, ou retorna o número de bytes gravados.
Valor de retorno
S_OK
E_INVALIDARG quando nenhum filtro é definido, ou quando dwChangeUnitIdIndex é maior que o número de IDs de unidade de alteração que definem o filtro.
E_POINTER
HRESULT_FROM_WIN32(ERROR_MORE_DATA) quando pbChangeUnitId é muito pequeno. Nessa situação, o número de bytes necessário é retornado em pcbIdSize.
SYNC_E_ID_FORMAT_MISMATCH quando a ID de unidade de alteração a ser retornada não é válida.