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