IKnowledgeWithMarkers::NextAllChangeUnitsRequiredMarker
Devuelve el siguiente elemento de la lista de elementos marcado como elemento que requiere todas las unidades de cambio.
HRESULT NextAllChangeUnitsRequiredMarker(
BYTE * pItemId,
DWORD * pIdSize);
Parámetros
- pItemId
[in, out, unique, size_is(*pIdSize)] Devuelve el siguiente identificador de elemento en la lista de identificadores de elemento que se han marcado como identificadores que requieren todas las unidades de cambio.
- pIdSize
[in, out] Especifica el número de bytes de pItemId. Devuelve el número de bytes necesarios para recuperar el identificador si pItemId es demasiado pequeño, o devuelve el número de bytes escritos.
Valor devuelto
S_OK
S_FALSE si no hay más elementos en la lista o si el objeto de conocimiento contiene elementos que se marcan como elementos que contienen todas las unidades de cambio.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) si pItemId es demasiado pequeño. En esta situación, el número necesario de bytes se devuelve en pIdSize.
E_INVALIDARG si pIdSize es más grande que el tamaño máximo que ha especificado el esquema de formato de identificador de elemento.
E_POINTER si los identificadores de elemento son de longitud variable y pIdSize es NULL.
Notas
Cuando se utilizan filtros personalizados, el proveedor de origen debe comprobar si los elementos que se agregan a un lote de cambios requieren que se incluyan todas las unidades de cambio. Para ello, llame a IKnowledgeWithMarkers::ContainsAllChangeUnitsRequiredMarker o enumere los elementos mediante NextAllChangeUnitsRequiredMarker. Cuando un elemento tiene un marcador que indica que requiere todas las unidades de cambio, el proveedor de origen debe incluir todas las unidades de cambio que pasan el filtro para ese elemento.