COMO: Escrever um empacotador de referências personalizado para interoperação COM utilizando o Visual C# .NET

• Um servidor COM que implementa o IUnmanagedServer interface.
• Um IUnmanagedServer que tem um método único que é denominado UnmanagedServerMethod . Este método requer um único parâmetro do tipo IUnmanaged como entrada.
• Um cliente .NET que tem uma instância de escreva IManaged.
• Um cliente do .NET que transmita a instância IManaged para UnmanagedServerMethod do servidor COM.

interface IUnmanaged : IUnknown
{
	HRESULT UnmanagedMethod([out, retval] LONG *RetVal);
};

public interface IManaged
{
	long ManagedMethod();
}

• Um servidor de .NET que implementa um método único que é denominado ManagedServerMethod . Este método requer um único parâmetro do tipo IManaged como entrada.
• Um cliente COM que tem uma instância de escreva IUnmanaged.
• Um cliente COM que passa a instância IUnmanaged para ManagedServerMethod do servidor .NET.

Voltar ao topo

Autenticação personalizada a partir de um cliente .NET a um servidor COM

Passos para criar um servidor de COM ATL

1. Abra o Microsoft Visual Studio .NET .
2. No menu ficheiro , aponte para Novo e, em seguida, clique em projecto .
3. Na caixa de diálogo Novo projecto , clique em Projectos do Visual C++ em Project Types e clique em Projecto ATL em modelos .
4. Na caixa de texto nome , escreva ComServer .
5. Clique em OK .
6. Na caixa de diálogo do Assistente , clique no separador Definições da aplicação .
7. Clique para desmarcar a caixa de verificação Attributed e, em seguida, clique em Concluir .
8. No Solution Explorer , clique com o botão direito do rato no nó ComServer (projecto) , aponte para Adicionar e, em seguida, clique em Adicionar classe .
9. Na caixa de diálogo Adicionar classe , clique em Objecto simples ATL em modelos e clique em Abrir .
10. Na caixa de diálogo Assistente de objectos simples ATL , escreva UnmanagedServer na caixa de texto nome curto e clique em Concluir .
11. No Solution Explorer , expanda os Ficheiros de origem .
12. Faça duplo clique em ComServer.idl para abrir o ficheiro .idl num editor. Adicionar definição de interface seguinte ficheiro .idl.

    [
    	object,
    	uuid(XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX),
    	helpstring("IUnmanaged Interface"),
    	pointer_default(unique)
    ]
    interface IUnmanaged : IUnknown
    {
    	HRESULT UnmanagedMethod([out, retval] LONG *RetVal);
    };

    substituir o conteúdo do atributo uuid com o GUID é gerado a partir da ferramenta guidgen . Na biblioteca, adicione a interface IUnmanaged como mostrado no código anterior. Isto expõe a interface através da biblioteca de tipos que é gerada. Adicione o seguinte código à instrução de biblioteca no ficheiro .idl:

    library ComServerLib
    {
    	importlib("stdole2.tlb");
    	//Add the following line to the idl file.
    	interface IUnmanaged;
    	...
    };
    

13. Na vista de classe , expanda ComServer .
14. Clique com o botão direito do rato IUnmanagedServer , aponte para Adicionar e, em seguida, clique em Adicionar método .
15. Na caixa de texto Nome do método , escreva UnmanagedServerMethod .
16. Clique para seleccionar os atributos de parâmetro de caixa de verificação.
17. Na caixa de combinação tipo de parâmetro , escreva IUnmanaged * .
18. Na caixa de texto parâmetro , escreva não geridos e, em seguida, clique em Adicionar .
19. Clique em Concluir .
20. No Solution Explorer , faça duplo clique UnmanagedServer.cpp .
21. Substitua o código predefinido que é gerado para o método CUnmanagedServer::UnmanagedServerMethod com o código que se segue:

    LONG data;
    HRESULT hr;
    hr = unmanaged->UnmanagedMethod(&data);
    if(FAILED(hr))
    	return hr;
    printf("The output of the IUnmanaged::UnmanagedMethod is : %d", data);
    return S_OK;

22. No menu criar , clique em criar soluções para criar a aplicação de servidor COM ATL.

Passos para criar um cliente de .NET

1. No menu ficheiro , aponte para Novo e, em seguida, clique em projecto .
2. Na caixa de diálogo Novo projecto , clique em Visual C# Projects em Project Types e clique em Aplicação de consola em modelos .
3. Clique para seleccionar a opção de Adicionar a solução e, em seguida, clique em OK .
4. No Solution Explorer , expanda ConsoleApplication1 , clique com o botão direito do rato em References e, em seguida, clique em Add Reference .
5. Na caixa de diálogo Adicionar referência do , clique no separador COM .
6. Clique em Biblioteca de tipos de 1.0 ComServer em Nome do componente e clique em Seleccionar .
7. Clique em OK .
8. Substituir o código predefinido Class1.cs o código que se segue:

   using System;
   using System.Runtime.InteropServices;
   
   public interface IManaged
   {
   	long ManagedMethod();
   }
   
   public class ManagedImplementation : IManaged
   {
   	public long ManagedMethod()
   	{
   		return 200;
   	}
   }
   
   class Class1
   {
   	static void Main(string[] args)	
   	{
   		comserverLib.IUnmanagedServer server = new comserverLib.UnmanagedServerClass();
   		IManaged managed = new ManagedImplementation();
   		server.UnmanagedServerMethod(managed);
   	}
   }
   

Passos para criar uma mensagem publicitária

1. Adicione o código que se segue Class1.cs:

   [
   	ComImport,
   	Guid("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"),
   	InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)
   ]
   public interface UCOMIUnmanaged
   {
   	long UnmanagedMethod();
   }
   
   public class ManagedIUnmanaged : UCOMIUnmanaged
   {
   	IManaged managedObj;
   
   	public ManagedIUnmanaged(IManaged managedObj)
   	{
   		if(managedObj != null)
   			this.managedObj = managedObj;
   		else
   			throw new ArgumentNullException("The instance of IManaged is null.");
   	}
   
   	public long UnmanagedMethod()
   	{
   		return  managedObj.ManagedMethod();
   	}
   }
   

   substituir o conteúdo do atributo GUID com o conteúdo do atributo uuid . O atributo de uuid é gerado para interface IUnmanaged no ficheiro ComServer.idl.

Passos para criar um empacotador de referências personalizado

1. Add the code that follows to Class1.cs:

   public class SampleMarshaler : ICustomMarshaler
   {
   	static SampleMarshaler marshaler;
   
   	public object MarshalNativeToManaged(IntPtr pNativeData)
   	{
   		return null;
   	}
   	
   	public IntPtr MarshalManagedToNative(object managedObj)
   	{
   		if(managedObj == null)
   			return IntPtr.Zero;
   		if(!(managedObj is IManaged))
   			throw new MarshalDirectiveException("This custom marshaler must be used on a IManaged derived type.");
   
   	ManagedIUnmanaged customObject = new ManagedIUnmanaged((IManaged)managedObj);
   	return Marshal.GetComInterfaceForObject(customObject, typeof(UCOMIUnmanaged));
   	}
   
   	public void CleanUpNativeData(IntPtr pNativeData)
   	{
   		Marshal.Release(pNativeData);
   	}
   
   	public void CleanUpManagedData(object managedObj)
   	{
   
   	}
   
   	public int GetNativeDataSize()
   	{
   		return -1;
   	}
   
   	public static ICustomMarshaler GetInstance(string cookie)
   	{
   		if(marshaler == null)
   			return marshaler = new SampleMarshaler();
   		return marshaler;
   	}
   }

2. Associa o empacotamento de referências da instância da interface a uma instância da interface IUnmanaged IManaged de empacotador de referências personalizado. Adicione o código que se segue Class1.cs para associar o empacotador de referências personalizado:

   [
   	ComImport,
   	Guid("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"),
   	InterfaceTypeAttribute(ComInterfaceType.InterfaceIsDual)
   ]
   public interface UCOMIUnmanagedServer
   {
   	void UnmanagedServerMethod(
   		[MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef=typeof(SampleMarshaler)), In]
   		object unmanaged);
   }

   é O GUID especificado com o atributo GUID o mesmo que o atributo de uuid especificado para a interface IUnmanagedServer .idl para o servidor COM.
3. Modificar o método principal Aula1 em Class1.cs da seguinte forma:

   static void Main(string[] args)
   {
   	UCOMIUnmanagedServer server = (UCOMIUnmanagedServer)new ComServerLib.UnmanagedServerClass();
   	IManaged managed = new ManagedImplementation();
   	server.UnmanagedServerMethod(managed);
   }

   quando o cliente não gerido chama o servidor não gerido, o cliente não gerido transmite uma instância de um objecto gerido para o servidor não gerido. O objecto gerido é personalizado empacotar as referências a um objecto que expõe a interface não gerida como esperada pelo servidor COM.
4. No menu criar , clique em criar soluções .
5. No Solution Explorer , clique com o botão direito do rato no nó de projecto ConsoleApplication1 e clique em Definir como projecto de arranque .
6. No menu Debug , clique em Iniciar .

Voltar ao topo

Autenticação personalizada a partir de um cliente COM para o .NET Server

Passos para criar um cliente COM

1. No menu ficheiro , aponte para Novo e, em seguida, clique em projecto .
2. Clique em Projectos do Visual C++ em Project Types e clique em Projecto ATL em modelos .
3. Na caixa de texto nome , escreva ComComponent e, em seguida, clique em OK .
4. Na caixa de diálogo Assistente de Projecto ATL , clique no separador Definições da aplicação .
5. Clique para desmarcar a caixa de verificação Attributed e, em seguida, clique em Concluir .
6. No Solution Explorer , clique com o botão direito do rato ComComponent (projecto) , aponte para Adicionar e, em seguida, clique em Adicionar classe .
7. Na caixa de diálogo Adicionar classe , clique em Objecto simples ATL em modelos e clique em Abrir .
8. Na caixa de diálogo Assistente de objectos simples ATL , escreva Unmanaged no nome de mais texto caixa e, em seguida, clique em Concluir .
9. Na Vista de classe , expanda ComComponent , clique com o botão direito do rato IUnmanaged , aponte para Adicionar e, em seguida, clique em Adicionar método .
10. Na caixa de diálogo Assistente de método , escreva UnmanagedMethod na caixa de texto Nome do método .
11. Selecione LONG * na lista em tipo de parâmetro .
12. Clique para seleccionar retval em atributos de parâmetro e, em seguida, escreva lRetVal na caixa de texto nome de parâmetro .
13. Clique em Adicionar e clique em Concluir .
14. No Solution Explorer , faça duplo clique Unmanaged.cpp para abrir o ficheiro.
15. Substituir o código por defeito para CUnmanaged::UnmanagedMethod o código que se segue:

    *lRetVal = 300;
    return S_OK;
    

16. No menu criar , clique em criar soluções para criar o componente COM.

Passos para criar um .NET Server

1. No menu ficheiro , aponte para Novo e, em seguida, clique em projecto .
2. Clique em Visual C# Projects em Project Types e clique em Biblioteca de classes em modelos .
3. Clique para seleccionar a opção de Adicionar a solução e, em seguida, clique em OK .
4. No ficheiro de Class1.cs gerado por predefinição, substitua o código por defeito pelo código que se segue:

   using System;
   using System.Runtime.InteropServices;
   
   [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
   public interface IManaged
   {
   	long ManagedMethod();
   }
   
   [ClassInterface(ClassInterfaceType.AutoDual)]
   public class ManagedServer
   {
   	public void ManagedServerMethod(IManaged managed)
   	{
   		Console.WriteLine("The output of IManaged.ManagedMethod is : {0}", managed.ManagedMethod());
   	}
   }
   

Passos para criar uma mensagem publicitária

1. No Solution Explorer , expanda ClassLibrary1 .
2. Na ClassLibrary1 , clique com o botão direito do rato em References e clique em Add Reference .
3. Na caixa de diálogo Adicionar referência do , clique no separador COM .
4. Clique em biblioteca de tipos de ComComponent 1.0 em nome do componente .
5. Clique em Seleccionar e clique em OK .
6. No ficheiro Class1.cs, adicione o código que se segue:

   [ComVisible(false)]
   public class ComUnmanaged : IManaged
   {
   	ComComponentLib.IUnmanaged unmanaged;
   
   	public ComUnmanaged(ComComponentLib.IUnmanaged unmanaged)
   	{
   		if(unmanaged != null)
   			this.unmanaged = unmanaged;
   		else
   			throw new ArgumentNullException("NULL");
   	}
   
   	public long ManagedMethod()
   	{
   		return unmanaged.UnmanagedMethod();
   	}
   }
   	

Passos para criar um empacotador de referências personalizado

1. Adicione o código que se segue Class1.cs:

   [ComVisible(false)]
   public class SampleMarshaler : ICustomMarshaler
   {
   	static SampleMarshaler marshaler;
   
   	public object MarshalNativeToManaged(IntPtr pNativeData)
   	{
   		if(pNativeData == IntPtr.Zero)
   			return null;
   
   		object rcw = Marshal.GetObjectForIUnknown(pNativeData);
   		if(!(rcw is ComComponentLib.IUnmanaged))
   			throw new ArgumentException("The object must implement IUnmanaged");
   
   		return new ComUnmanaged((ComComponentLib.IUnmanaged) rcw);
   	}
   
   	public IntPtr MarshalManagedToNative(object managedObj)
   	{
   		return IntPtr.Zero;
   	}
   
   	public void CleanUpNativeData(IntPtr pNativeData)
   	{
   		Marshal.Release(pNativeData);
   	}
   
   	public void CleanUpManagedData(object managedObj)
   	{
   
   	}
   
   	public int GetNativeDataSize()
   	{
   		return -1;
   	}
   
   	public static ICustomMarshaler GetInstance(string cookie)
   	{
   		if(marshaler == null)
   			return marshaler = new SampleMarshaler();
   		return marshaler;
   	}
   }

2. Adicione MarshalAsAttribute o parâmetro é personalizada empacotar as referências. Modifique o código para ManagedServerMethod da seguinte forma:

   public void ManagedServerMethod(
   	[MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef=typeof(SampleMarshaler)), In]
   	IManaged managed)
   {
   	Console.WriteLine("The output of IManaged.ManagedMethod is : {0}", managed.ManagedMethod());
   }

3. No menu criar , clique em criar soluções .
4. No menu ficheiro , aponte para Novo e, em seguida, clique em projecto .
5. Na caixa de diálogo Novo projecto , clique em Projectos do Visual C++ em Project Types e clique em Project Win32 em modelos .
6. Na caixa de texto nome , escreva ComClient .
7. Clique para seleccionar a opção de Adicionar a solução e, em seguida, clique em OK .
8. Na caixa de diálogo Assistente de aplicação de Win32 , clique no separador Definições da aplicação .
9. Clique para seleccionar a Aplicação de consola de opção na secção Escreva aplicação e, em seguida, clique em Concluir .
10. No Solution Explorer , expanda ComClient e faça duplo clique Stdafx.h ficheiro para abrir esse ficheiro. Adicione o código que se segue para o ficheiro:

    #import "ComComponent.tlb" no_namespace raw_interfaces_only named_guids
    #import "ClassLibrary1.tlb" no_namespace raw_interfaces_only named_guids

11. No Solution Explorer , expanda ComClient e, em seguida, faça duplo clique no ficheiro ComClient.cpp para abrir esse ficheiro. Adicione o código que se segue para o _tmain do file:

    #include "stdafx.h"
    int _tmain(int argc, _TCHAR* argv[])
    {
    	HRESULT hr;
    	IUnmanaged *unmanagedObj;
    	_ManagedServer *managedServer;
    
    	CoInitialize(NULL);
    	hr = CoCreateInstance(CLSID_Unmanaged, NULL, CLSCTX_INPROC_SERVER, IID_IUnmanaged, (LPVOID *)&unmanagedObj);
    	if(FAILED(hr))
    		goto Error;
    
    	hr = CoCreateInstance(CLSID_ManagedServer, NULL, CLSCTX_INPROC_SERVER, IID__ManagedServer, (LPVOID *)&managedServer);
    	if(FAILED(hr))
    		goto Error;
    
    	hr = managedServer->ManagedServerMethod(unmanagedObj);
    	if(FAILED(hr))
    		goto Error;
    
    	return 0;
    
    Error:
    	CoUninitialize();
    	return hr;
    }

12. Para gerar o ClassLibrary1.tlb, escreva o comando que se segue na linha de comandos:
    RegAsm /tlb ClassLibrary1.dll
    Verifique se o ficheiro ClassLibrary1.dll está no directório de compilação para o projecto ClassLibrary1. O ClassLibrary1.dll gera o ClassLibrary1.tlb e também regista a biblioteca de classes.
13. Copiar o ficheiro ClassLibrary1.tlb e o ComComponent.tlb ficheiro para o directório do projecto para a aplicação ComClient.
14. No menu criar , clique em criar soluções .
15. Copiar o ficheiro de ClassLibrary1.dll e o ficheiro Interop.comclientLib.dll do directório de compilação do ClassLibrary1 projecto para o directório compilação da aplicação de consola ComClient.
16. No Solution Explorer , clique com o botão direito do rato ComClient e clique em Definir como projecto de arranque .
17. No menu Debug , clique em Iniciar .

Voltar ao topo