IAssociativeDataStorageOutput::CreateNode: различия между версиями
Перейти к навигации
Перейти к поиску
| Строка 1: | Строка 1: | ||
{{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_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-битовый беззнаковый целый код ошибки, который в случае успешного выполнения неотрицателен.}} | {{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).