Share via


IKnowledgeBuilder::Initialize

Initializes a new instance of the IKnowledgeBuilder class that contains the specified knowledge version and the ID format schema of the provider.

Syntax

HRESULT Initialize(
  DWORD dwVersion,
  const ID_PARAMETERS* pidParameters);

Parameters

Term

Definition

dwVersion

[in] The version of the knowledge structure to build. This must be one of the values from the SYNC_SERIALIZATION_VERSION enumeration.

pidParameters

[in] The ID format schema of the provider.

Return Value

  • S_OK.

  • E_POINTER.

  • E_OUTOFMEMORY.

  • SYNC_E_INVALIDOPERATION if the builder is in an improper state, such as when the Initialize method has already been called.

  • SYNC_E_INVALIDVERSION if dwVersion is not a supported version.

Remarks

Initialize must be called before any other IKnowledgeBuilder method. All other IKnowledgeBuilder methods will return SYNC_E_INVALIDOPERATION if Initialize has not previously been called.

See Also

Reference

IKnowledgeBuilder Interface