Função RpcServerInterfaceGroupActivate (rpcdce.h)
A função RpcServerInterfaceGroupActivate informa ao runtime do servidor RPC para registrar as interfaces e pontos de extremidade do grupo de interfaces e começar a escutar chamadas.
Sintaxe
RPC_STATUS RpcServerInterfaceGroupActivate(
[in] RPC_INTERFACE_GROUP IfGroup
);
Parâmetros
[in] IfGroup
Um RPC_INTERFACE_GROUP de RpcServerInterfaceGroupCreate que define o grupo de interfaces a ser ativado.
Valor retornado
| Valor | Significado |
|---|---|
|
A chamada foi bem-sucedida. |
|
Não há suporte para a sequência de protocolo neste host. |
|
A sequência de protocolo é inválida. |
|
O formato do ponto de extremidade é inválido. |
|
O sistema está sem memória. |
|
O descritor de segurança para um ponto de extremidade ou interface é inválido. |
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
Comentários
RpcServerInterfaceGroupActivate faz a maior parte do trabalho de inicialização que os aplicativos de servidor RPC precisam fazer. Ele executa as seguintes operações:
- Instrui o runtime do RPC a começar a escutar chamadas.
- Registra os pontos de extremidade com o runtime do servidor.
- Registra as interfaces com o runtime do servidor.
- Registra os pontos de extremidade e as interfaces com o mapeador de ponto de extremidade RPC.
RpcServerInterfaceGroupActivate é atômico. Se em algum momento a operação falhar, todos os itens registrados anteriormente serão desfeitos.
As chamadas podem ser enviadas para o aplicativo de servidor antes que essa função retorne.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | rpcdce.h (inclua Rpc.h) |
| Biblioteca | Rpcrt4.lib |
| DLL | Rpcrt4.dll |