Função RpcServerRegisterIf (rpcdce.h)

Artigo
08/25/2023

A função RpcServerRegisterIf registra uma interface com a biblioteca de tempo de execução RPC.

Sintaxe

RPC_STATUS RpcServerRegisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  RPC_MGR_EPV   *MgrEpv
);

Parâmetros

IfSpec

Estrutura gerada por MIDL que indica a interface a ser registrada.

MgrTypeUuid

Ponteiro para um UUID de tipo a ser associado ao parâmetro MgrEpv . Especificar um valor de parâmetro nulo (ou um UUID nulo) registra IfSpec com um UUID de tipo nulo.

MgrEpv

EPV (vetor de ponto de entrada) das rotinas do gerente. Para usar o EPV padrão gerado por MIDL, especifique um valor nulo. Para obter mais informações, consulte RPC_MGR_EPV.

Retornar valor

Retorna RPC_S_OK após o sucesso.

Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Comentários

Um servidor pode registrar um número ilimitado de interfaces com a biblioteca de tempo de execução RPC. O registro disponibiliza uma interface para clientes usando um identificador de associação para o servidor. Para registrar uma interface, o código do aplicativo de servidor chama RpcServerRegisterIf. Para cada implementação de uma interface que um servidor oferece, ele deve registrar um EPV de gerenciador separado.

Ao chamar RpcServerRegisterIf, o servidor fornece as seguintes informações:

Especificação da interface
A especificação da interface é uma estrutura de dados gerada pelo compilador MIDL. O servidor especifica a interface usando o parâmetro IfSpec .
Tipo de gerenciador UUID e EPV do gerente
O tipo de gerenciador UUID e o EPV do gerente determinam qual rotina de gerente é executada quando um servidor recebe uma solicitação de chamada de procedimento remoto de um cliente.

O servidor especifica o tipo de gerente UUID e EPV usando os parâmetros MgrTypeUuid e MgrEpv . Observe que, ao especificar um UUID de tipo de gerente não nulo, o servidor também deve chamar a função RpcObjectSetType para registrar objetos desse tipo não nulo.

Se o aplicativo de servidor precisar registrar uma interface de escuta automática ou usar uma função de retorno de chamada para fins de autenticação, use RpcServerRegisterIfEx.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	rpcdce.h (inclua Rpc.h)
Biblioteca	Rpcrt4.lib
DLL	Rpcrt4.dll