IAssociativeDataStorage::CreateNode

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
return_code_t PLATFORM_NATIVE_CALLING_CONVENTION CreateNode(const void* pKey, std::uint32_t cbKey,  IDataStorage** ppNode) const noexcept;

Создает новый пустой узел ассоциативного хранилища данных.

Параметры
[In]pKeyУказатель на ключ, который должен идентифицировать создаваемый элемент.
cbKeyДлина ключа.
[out]ppNodeУказатель, который на выходе принимает адрес реализации хранилища данных, для хранения значения, ассоциированного с ключом, с интерфейсом IDataStorage.
Возвращаемое значение:
32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения неотрицателен. Если реализация ассоциативного хранилища данных требует уникальности ключа, и ключ, эквивалентный ключу pKey уже существует, должно возвращаться значение CHSVERROR_ALREADY_EXISTS (0xa417000a).