interface_implementation_base::RepresentAs

return_code_t PLATFORM_NATIVE_CALLING_CONVENTION RepresentAs(typename interface_conversion_policy::interface_identifier_type type_id, void** ppInterface) noexcept;

Условно определенный метод, который осуществляет преобразование в интерфейс, заданный идентификатором.

Параметры

	type_id	Идентификатор интерфейса, имеющий тип interface_conversion_policy::interface_identifier_type.
[out]	ppInterface	Выходной указатель, принимающий интерфейс типа, заданного идентификатором, или 0 в случае ошибки.

Возвращаемое значение:

32-битовый целый код ошибки, который в случае успешного выполнения неотрицателен (старший бит сброшен). В случае, если интерфейс, заданный идентификатором, не поддерживается, возвращается код CHSVERROR_INVALID_PARAMETER.

Если шаблон interface_implementation_base специализирован с политикой interface_ref_ctr_policy, определяющей подсчет ссылок, то владение объектом, возвращенным через параметр ppInterface, разделяется с клиентом, вызвавшим RepresentAs. В случае, если подсчет ссылок не производится, например, если в качестве interface_ref_ctr_policy указана политика ref_ctr_policy_none, разделения владениея не производится.

Поэтому в случае успешного завершения функции, объект возвращенный через параметр ppInterface, необходимо закрывать вызовом его метода Release отдельно и независимо от объекта, над которым применен метод RepresentAs, но только когда реализация осуществляет подсчет ссылок.

Для проверки доступности того или иного интерфейса предпочтительно использовать метод IsInterfaceAvailable.

Метод определен только в случае, если преобразование типов задано политикой interface_conversion_policy.