Desenvolver o Cliente

O desenvolvimento de um programa cliente RPC é semelhante ao desenvolvimento do programa servidor. Para obter informações sobre como desenvolver um programa de servidor RPC, consulte Desenvolvendo o servidor.

Como no desenvolvimento do servidor, o programa cliente deve incluir o arquivo de cabeçalho que o compilador MIDL gera a partir do arquivo .idl. O compilador MIDL também gera um arquivo de origem C contendo o stub do cliente. Você deve compilar este arquivo de origem C e vinculá-lo ao seu programa cliente. (Além disso, o compilador MIDL gera um arquivo de origem C contendo o stub do servidor, mas isso não é relevante para esta discussão.)

Além de compilar e vincular o stub do cliente com seus arquivos de programa, você deve vincular a biblioteca de importação (e quaisquer outras bibliotecas que seu programa cliente precisa) ao seu programa cliente. O processo de criação de um programa cliente RPC é ilustrado no diagrama a seguir.

O exemplo na ilustração anterior demonstra a criação de um programa cliente RPC chamado MyClnt.exe. O primeiro passo é definir a interface no arquivo MyApp.idl. O compilador MIDL usa MyApp.idl para gerar o arquivo MyApp_c.c, que contém o stub do cliente. Ele também gera o arquivo MyApp.h, que o programa cliente deve incluir. O programa cliente também precisará incluir os arquivos RPC.h e RPCNDR.h.

O programa cliente em si é criado no arquivo MyClnt.c. Em um projeto real, o programa cliente normalmente seria composto de vários arquivos de origem C. Todos eles teriam de ser compilados e interligados. No entanto, este exemplo usa apenas um arquivo para simplificar.

Os arquivos MyClnt.c e MyApp_c.c são compilados e vinculados com a biblioteca de tempo de execução RPC e quaisquer outras bibliotecas que o programa cliente precisa. O resultado é um programa cliente executável chamado MyClnt.exe.

Se não compilar o seu ficheiro IDL no modo de compatibilidade OSF (/osf), o seu programa cliente deve fornecer uma função para alocar memória e uma função para desalocá-la. Para o Windows 2000 e versões posteriores, o modo recomendado é /Oicf. Para obter detalhes, consulte Como a memória é alocada e desalocadae Ponteiros e alocação de memória.