Partilhar via

Desenvolvendo a interface

Uma interface RPC descreve as funções remotas que o programa de servidor implementa. A interface garante que o cliente e o servidor se comuniquem usando as mesmas regras quando o cliente invoca um procedimento remoto que o servidor oferece. Uma interface consiste em um nome de interface, alguns atributos, definições opcionais de tipo ou constante e um conjunto de declarações de procedimento. Cada declaração de procedimento deve conter um nome de procedimento, tipo de retorno e lista de parâmetros.

As interfaces são definidas no Microsoft Interface Definition Language (MIDL). Se você estiver familiarizado com C ou C++, as definições de interface MIDL parecerão bastante simples. O MIDL se assemelha a C e C++ de muitas maneiras.

Ao desenvolver um aplicativo RPC, um editor de texto é usado para definir a interface e armazená-la em um arquivo de texto com uma extensão .idl. Para obter mais informações, consulte Os arquivos IDL e ACF. O compilador MIDL gera um arquivo de cabeçalho que seu programa inclui nos arquivos de origem do cliente e do servidor. O compilador MIDL também gera dois arquivos de código-fonte C. Você compila e vincula um deles ao seu programa cliente e o outro ao seu programa de servidor. Esses dois arquivos de origem C são os stubs cliente e servidor. Para ter uma visão geral dos stubs de cliente e servidor, consulte Como funciona o RPC. Para obter uma visão geral sobre o compilador MIDL, consulte compilando um arquivo MIDL.

Por padrão, o stub do cliente e do servidor têm o mesmo nome, o que pode causar problemas se o cliente se vincular ao stub do servidor, ou vice-versa. O uso da opção MIDL /prefix impede que esse erro comum ocorra.

A ilustração a seguir mostra o processo de criação de uma interface.

criação de stubs de cliente e servidor com a opção /prefix evita problemas acidentais de compilação

É possível que você também precise especificar um arquivo de configuração do aplicativo (ACF) para entrada no compilador MIDL. Para obter mais informações sobre arquivos de configuração de aplicativos, consulte Os arquivos IDL e ACF.

Além do compilador MIDL, você normalmente precisará usar o utilitário Uuidgen para gerar um identificador único universal (UUID, intercambiável com o termo GUID). Esta seção apresenta informações sobre essas duas ferramentas, divididas nos seguintes tópicos: