Compartilhar via


RCW (Runtime Callable Wrapper)

O common language runtime expõe objetos COM através de um proxy chamado RCW (Runtime Callable Wrapper). Embora o RCW pareça ser um objeto comum para clientes .NET, a função principal dele é realizar marshaling de chamadas entre um cliente .NET e um objeto COM.

O runtime cria exatamente um RCW para cada objeto COM, independentemente do número de referências que existem nesse objeto. O runtime mantém um único RCW por processo para cada objeto. Se você criar um RCW em um domínio de aplicativo ou apartment e, em seguida, passar uma referência a outro domínio de aplicativo ou apartment, um proxy para o primeiro objeto será usado. Observe que esse proxy é um novo objeto gerenciado e não o mesmo que o RCW inicial; isso significa que os dois objetos gerenciados não são iguais, mas representam o mesmo objeto COM. Conforme mostra a ilustração a seguir, qualquer número de clientes pode conter uma referência a objetos COM que expõem interfaces INew e INewer.

A seguinte imagem mostra o processo para acessar objetos COM por meio do RCW (Runtime Callable Wrapper):

Process for accessing COM objects through the RCW.

Usando metadados derivados de uma biblioteca de tipos, o runtime cria o objeto COM que está sendo chamado e um wrapper para esse objeto. Cada RCW mantém um cache de ponteiros de interface no objeto COM que ele encapsula e, além disso, libera sua referência no objeto COM quando o RCW não é mais necessário. O runtime executa a coleta de lixo no RCW.

Entre outras atividades, o RCW realiza marshaling de dados entre código gerenciado e não gerenciado, em nome do objeto encapsulado. Especificamente, o RCW fornece marshalling para argumentos de método e valores retornados do método sempre que o cliente e o servidor têm representações diferentes dos dados transmitidos entre eles.

O wrapper padrão impõe regras de marshalling internas. Por exemplo, quando um cliente .NET passa um tipo de string como parte de um argumento para um objeto não gerenciado, o wrapper converte a string em um tipo BSTR. Se o objeto COM retornar um BSTR ao chamador gerenciado, o chamador receberá uma string. Tanto o cliente quanto o servidor enviam e recebem dados com os quais estão familiarizados. Outros tipos não exigem conversão. Por exemplo, um wrapper padrão sempre passará um inteiro de 4 bytes entre código gerenciado e não gerenciado sem converter o tipo.

Marshalling de interfaces selecionadas

A meta principal do RCW (Runtime Callable Wrapper) é ocultar as diferenças entre os modelos de programação gerenciado e não gerenciado. Para criar uma transição suave, o RCW consome interfaces COM selecionadas sem expô-las ao cliente .NET, conforme mostrado na ilustração a seguir.

A seguinte imagem mostra as interfaces COM e o RCW (Runtime Callable Wrapper):

Screenshot of the runtime callable wrapper with interfaces.

Quando criado como um objeto associado precocemente, o RCW é um tipo específico. Ele implementa as interfaces que o objeto COM implementa e expõe os métodos, propriedades e eventos das interfaces do objeto. Na ilustração, o RCW expõe a interface INew mas consome as interfaces IUnknown e IDispatch. Além disso, o RCW expõe todos os membros da interface INew para o cliente .NET.

O RCW consome as interfaces listadas na tabela a seguir, as quais são expostas pelo objeto que ele encapsula.

Interface Descrição
IDispatch Para associação tardia a objetos COM por meio de reflexão.
IErrorInfo Fornece uma descrição textual do erro, sua origem, um arquivo de Ajuda, um contexto de Ajuda e o GUID da interface que definiu o erro (sempre GUID_NULL para classes do .NET).
IProvideClassInfo Se o objeto COM sendo empacotado implementa IProvideClassInfo, o RCW extrai as informações de tipo dessa interface para fornecer uma melhor identidade de tipo.
IUnknown Para gerenciamento do tempo de vida, coerção de tipo e identidade de objeto:

– Identidade do objeto
O runtime faz distinção entre os objetos COM, comparando o valor da interface IUnknown para cada objeto.
– Coerção de tipo
O RCW reconhece a descoberta de tipo dinâmico executada pelo método QueryInterface.
– Gerenciamento do tempo de vida
Usando o QueryInterface método RCW obtém e mantém uma referência a um objeto não gerenciado até o runtime executar a coleta de lixo no wrapper, que libera o objeto não gerenciado.

O RCW, opcionalmente, consome as interfaces listadas na tabela a seguir, as quais são expostas pelo objeto que ele encapsula.

Interface Descrição
IConnectionPoint e IConnectionPointContainer O RCW converte objetos que expõem o estilo do evento de ponto de conexão para eventos com base em delegado.
IDispatchEx (somente .NET Framework) Se a classe implementa IDispatchEx, o RCW implementa IExpando. A interface IDispatchEx é uma extensão da interface IDispatch que, ao contrário de IDispatch, permite a enumeração, adição, exclusão e chamada de membros que diferencia maiúsculas de minúsculas.
IEnumVARIANT Permite que os tipos COM que dão suporte a enumerações sejam tratados como coleções.

Confira também