IKnowledgeWithMarkers::NextAllChangeUnitsRequiredMarker
Retorna o próximo item da lista de itens marcados como aqueles que requerem todas as unidades de alteração.
HRESULT NextAllChangeUnitsRequiredMarker(
BYTE * pItemId,
DWORD * pIdSize);
Parâmetros
- pItemId
[in, out, unique, size_is(*pIdSize)] Retorna a ID do próximo item da lista de IDs de itens marcados como aqueles que requerem todas as unidades de alteração.
- pIdSize
[in, out] Especifica o número de bytes em pItemId. Retorna o número de bytes necessários para recuperar a ID quando pItemId é muito pequeno, ou retorna o número de bytes gravados.
Valor de retorno
S_OK.
S_FALSE quando não há mais itens na lista ou o objeto de conhecimento contém itens que são marcados como aqueles que contêm todas as unidades de alteração.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) quando pItemId for muito pequeno. Nessa situação, o número de bytes necessário é retornado em pIdSize.
E_INVALIDARG quando pIdSize é maior que o tamanho máximo especificado pelo esquema de formato da ID do item.
E_POINTER quando as IDs de item têm comprimento variável e pIdSize é NULL.
Comentários
Quando são usados filtros personalizados, o provedor de origem deve verificar se os itens adicionados a um lote de alterações requerem que todas as unidades de alteração sejam incluídas. Para isso, chame IKnowledgeWithMarkers::ContainsAllChangeUnitsRequiredMarker ou enumere itens usando NextAllChangeUnitsRequiredMarker. Quando o item é marcado para exigir todas as unidades de alteração, o provedor de origem deve incluir todas as unidades de alteração que passam pelo filtro desse item.