IAssociativeDataStorageOutput::CreateNode: различия между версиями

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
(Новая страница: «{{function_begin | return_code_t CreateNode(const void* pKey, std::uint32_t cbKey, IDataStorage** ppNode) const noexcept; |{{IAssociativeDataStorageOutput::Creat…»)
 
 
(не показаны 2 промежуточные версии этого же участника)
Строка 1: Строка 1:
{{function_begin | return_code_t CreateNode(const void* pKey, std::uint32_t cbKey,  IDataStorage** ppNode) const noexcept; |{{IAssociativeDataStorageOutput::CreateNode brief}}}}
{{function_begin|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION CreateNode(const void* pKey, std::uint32_t cbKey,  IDataStorage** ppNode) const noexcept; |{{IAssociativeDataStorageOutput::CreateNode brief}}}}
{{function_paramlist begin}}
{{function_paramlist begin}}
{{function_paramlist add|pKey|.|paramdir=[In]}}
{{function_paramlist add|pKey|Указатель на ключ, который должен идентифицировать создаваемый элемент.|paramdir=[In]}}
{{function_paramlist add|cbKey|.}}
{{function_paramlist add|cbKey|Длина ключа.}}
{{function_paramlist add|ppNode|.|paramdir=[out]}}
{{function_paramlist add|ppNode|Указатель, который на выходе принимает адрес реализации хранилища данных, для хранения значения, ассоциированного с ключом, с интерфейсом [[IDataStorage]].|paramdir=[out]}}
{{function_paramlist end}}
{{function_paramlist end}}
{{function_return_value|32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения равен 0.}}
{{function_return_value|32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения неотрицателен. Если реализация ассоциативного хранилища данных требует уникальности ключа, и ключ, эквивалентный ключу <tt>pKey</tt> уже существует, должно возвращаться значение CHSVERROR_ALREADY_EXISTS (0xa417000a).}}
{{function_end}}
{{function_end}}

Текущая версия на 18:27, 18 августа 2019

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).