Função RpcEpUnregister (rpcdce.h)
A função RpcEpUnregister remove informações de endereço do servidor do banco de dados local do mapa de ponto de extremidade.
Sintaxe
RPC_STATUS RpcEpUnregister(
RPC_IF_HANDLE IfSpec,
RPC_BINDING_VECTOR *BindingVector,
UUID_VECTOR *UuidVector
);
Parâmetros
IfSpec
Interface para cancelar o registro do banco de dados de mapa de ponto de extremidade local.
BindingVector
Ponteiro para um vetor de identificadores de associação para cancelar o registro.
UuidVector
Ponteiro para um vetor opcional de UUIDs de objeto para cancelar o registro. O aplicativo de servidor constrói esse vetor. RpcEpUnregister cancela o registro de todos os elementos de banco de dados de mapa de ponto de extremidade que correspondem aos parâmetros IfSpec e BindingVector especificados e ao objeto UUID(s).
Um valor de parâmetro nulo indica que não há UUIDs de objeto para cancelar o registro.
Valor retornado
| Valor | Significado |
|---|---|
|
A chamada foi bem-sucedida. |
|
Sem associações. |
|
O identificador de associação era inválido. |
|
Esse era o tipo errado de associação para a operação. |
Comentários
A função RpcEpUnregister remove elementos do banco de dados de mapa de ponto de extremidade do host local. Um aplicativo de servidor chama essa função somente quando o servidor tiver registrado pontos de extremidade anteriormente e o servidor quiser remover essas informações de endereço do banco de dados de mapa de ponto de extremidade.
Especificamente, RpcEpUnregister permite que um aplicativo de servidor remova seus próprios elementos de banco de dados de mapa de ponto de extremidade (informações de endereço do servidor) com base na especificação da interface ou na especificação da interface e nas UUID(s) do objeto dos recursos oferecidos.
O servidor chama a função RpcServerInqBindings para obter o parâmetro BindingVector necessário. Para cancelar o registro de pontos de extremidade selecionados, o servidor pode remover o vetor de associação antes de chamar essa função.
RpcEpUnregister cria um produto cruzado dos parâmetros IfSpec, BindingVector e UuidVector e remove cada elemento no produto cruzado do banco de dados de mapa de ponto de extremidade.
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 |