IKnowledgeWithMarkers::NextAllChangeUnitsRequiredMarker
Gibt das nächste Element aus der Liste der Elemente zurück, die als Elemente markiert wurden, für die alle Änderungseinheiten erforderlich sind.
HRESULT NextAllChangeUnitsRequiredMarker(
BYTE * pItemId,
DWORD * pIdSize);
Parameter
- pItemId
[in, out, unique, size_is(*pIdSize)] Gibt die nächste Element-ID in der Liste der Element-IDs zurück, die so markiert wurden, dass für sie alle Änderungseinheiten erforderlich sind.
- pIdSize
[in, out] Gibt die Anzahl der Bytes in pItemId an. Gibt entweder die Anzahl der zum Abrufen der ID erforderlichen Bytes zurück, wenn pItemId zu klein ist, oder die Anzahl der geschriebenen Bytes.
Rückgabewert
S_OK.
S_FALSE, wenn es keine Elemente mehr in der Liste gibt oder das Wissensobjekt Elemente enthält, die so markiert wurden, dass für sie alle Änderungseinheiten erforderlich sind.
HRESULT_FROM_WIN32(ERROR_MORE_DATA), wenn pItemId zu klein ist. In dieser Situation wird in pIdSize die erforderliche Anzahl der Bytes zurückgegeben.
E_INVALIDARG, wenn pIdSize größer ist als die maximale vom Element-ID-Formatschema angegebene Größe.
E_POINTER, wenn Element-IDs eine variable Länge haben und pIdSize NULL ist.
Hinweise
Wenn benutzerdefinierte Filter verwendet werden, muss der Quellenanbieter prüfen, ob es für Elemente, die einem Änderungsbatch hinzugefügt werden, erforderlich ist, dass alle Änderungseinheiten enthalten sind. Hierzu rufen Sie entweder IKnowledgeWithMarkers::ContainsAllChangeUnitsRequiredMarker auf, oder Sie listen Elemente mit NextAllChangeUnitsRequiredMarker auf. Wenn ein Element so markiert ist, dass alle Änderungseinheiten erforderlich sind, muss der Quellenanbieter alle Änderungseinheiten einschließen, die den Filter für dieses Element passieren.