INode::RepresentAs
Перейти к навигации
Перейти к поиску
return_code_t RepresentAs(NodeTypeId type_id, void** ppInterface) noexcept;
Осуществляет преобразование в интерфейс, заданный идентификатором.
- Параметры
type_id 32-х битовое целое, принимающее одно из следующих значений идентификаторов интерфейсов. Символическое имя Целочисленное значение Описание NodeType 0 Идентификатор интерфейса INode. TCPNodeType 1 Идентификатор интерфейса ITCPNode. TCPNodeCustomRequestHandlerType 2 Идентификатор интерфейса ITCPNodeCustomRequestHandler. [out] ppInterface Выходной указатель, принимающий интерфейс заданного типа или 0 в случае ошибки. - Возвращаемое значение:
- 32-битовый целый код ошибки, который в случае успешного выполнения неотрицателен (старший бит сброшен). В случае, если интерфейс, заданный идентификатором, не поддерживается, возвращается код CHSVERROR_INVALID_PARAMETER.
В случае успешного завершения функции, полученный через параметр ppInterface объект необходимо закрывать вызовом его метода Release отдельно и независимо от объекта, над которым применен метод RepresentAs.
Для проверки доступности того или иного интерфейса предпочтительно использовать метод INode::IsInterfaceAvailable.