Compartilhar via

Função RpcMgmtEpUnregister (rpcdce.h)

  • Artigo

[Essa função tem suporte apenas no Windows NT e no Windows Me/98/95; ela retorna EP_S_CANT_PERFORM_OP em outras versões do Windows.]

A função RpcMgmtEpUnregister remove informações de endereço do servidor de um mapa de ponto de extremidade.

Sintaxe

RPC_STATUS RpcMgmtEpUnregister(
  RPC_BINDING_HANDLE EpBinding,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE Binding,
  UUID               *ObjectUuid
);

Parâmetros

EpBinding

Host cujos elementos de mapa de ponto de extremidade devem ser cancelados. Para remover elementos do mesmo host que o aplicativo de chamada, o aplicativo especifica um valor NULL. Para remover elementos de outro host, o aplicativo especifica um identificador de associação de servidor para qualquer servidor que resida nesse host. Observe que o aplicativo pode especificar o mesmo identificador de associação que está usando para fazer outras chamadas de procedimento remoto.

IfId

Identificador de interface a ser removido do mapa do ponto de extremidade.

Binding

Identificador de associação a ser removido.

ObjectUuid

UUID de objeto opcional a ser removido. O valor NULL indica que não há UUID de objeto a ser removido.

Retornar valor

Código de retorno Descrição
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_CANT_PERFORM_OP
 Não é possível executar a operação solicitada.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

A função RpcMgmtEpUnregister cancela o registro de um elemento do mapa do ponto de extremidade. Um programa de gerenciamento chama essa função para remover endereços de servidores que não estão mais disponíveis ou para remover endereços de servidores que dão suporte a objetos que não são mais oferecidos.

O parâmetro EpBinding deve ser uma associação completa. O objeto UUID associado ao parâmetro EpBinding deve ser um UUID nulo. Especificar uma UUID não nula faz com que a função falhe com o código status EPT_S_CANT_PERFORM_OP. Além das informações do host e da UUID do objeto, todas as informações nesse argumento são ignoradas.

Um aplicativo chama RpcMgmtEpEltInqNext para exibir elementos de mapa de ponto de extremidade local. Em seguida, o aplicativo pode remover os elementos usando RpcMgmtEpUnregister.

Nota Use essa função com cuidado. A remoção de elementos do mapa do ponto de extremidade local pode tornar os servidores indisponíveis para aplicativos cliente que ainda não têm um identificador de associação totalmente associado ao servidor.
 

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcEpRegister

RpcEpUnregister

RpcMgmtEpEltInqNext