Função RpcEpUnregister (rpcdce.h)

  • Artigo

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
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_NO_BINDINGS
 Sem associações.
RPC_S_INVALID_BINDING
 O identificador de associação era inválido.
RPC_S_WRONG_KIND_OF_BINDING
 Esse era o tipo errado de associação para a operação.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

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

Confira também

RpcEpRegister

RpcEpRegisterNoReplace

RpcNsBindingUnexport

RpcServerInqBindings