ISyncKnowledge2::GetLowestUncontainedId method (winsync.h)

  • Article

Returns the lowest item ID that is not contained in this knowledge and that is contained in the specified knowledge.

Syntax

HRESULT GetLowestUncontainedId(
  [in]      ISyncKnowledge2 *piSyncKnowledge,
  [in, out] BYTE            *pbItemId,
  [in, out] DWORD           *pcbItemIdSize
);

Parameters

[in] piSyncKnowledge

The item ID that is returned in pbItemId is contained in piSyncKnowledge.

[in, out] pbItemId

The lowest item ID that is contained in piSyncKnowledge and is not contained in this knowledge.

[in, out] pcbItemIdSize

The number of bytes in pbItemId. Returns either the number of bytes that are required to retrieve the ID when pbItemId is too small, or the number of bytes written.

Return value

The possible return codes include, but are not limited to, the values shown in the following table.

Return code Description
S_OK
 The method succeeded.
S_FALSE
 piSyncKnowledge is contained in this knowledge. In this situation, there is no uncontained item ID to return.
E_INVALIDARG
 The ID format schema of piSyncKnowledge is not the same as the ID format schema of this knowledge.
E_POINTER
 Invalid pointer.
HRESULT_FROM_WIN32(ERROR_MORE_DATA)
 pbItemId is too small. In this situation, the required number of bytes is returned in pcbItemIdSize.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header winsync.h

See also

ISyncKnowledge Interface

ISyncKnowledge2 Interface