Função RpcServerInterfaceGroupInqBindings (rpcdce.h)

  • Artigo

A função RpcServerInterfaceGroupInqBindings retorna os identificadores de associação sobre os quais chamadas de procedimento remoto podem ser recebidas para o grupo de interfaces especificado.

Sintaxe

RPC_STATUS RpcServerInterfaceGroupInqBindings(
  [in]  RPC_INTERFACE_GROUP IfGroup,
  [out] RPC_BINDING_VECTOR  **BindingVector
);

Parâmetros

[in] IfGroup

Um RPC_INTERFACE_GROUP de RpcServerInterfaceGroupCreate que define o grupo de interfaces para o qual as associações devem ser consultadas.

[out] BindingVector

Retorna um ponteiro para um ponteiro para um vetor de identificadores de associação de servidor.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_NO_BINDINGS
 Não há associações.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Um aplicativo de servidor chama RpcServerInterfaceGroupInqBindings para obter um vetor de identificadores de associação de servidor para o grupo de interfaces especificado. A biblioteca de tempo de execução RPC cria identificadores de associação para um grupo de interfaces quando um aplicativo de servidor chama a função RpcServerInterfaceGroupActivate .

O vetor de associação retornado pode conter identificadores de associação com pontos de extremidade dinâmicos ou identificadores de associação com pontos de extremidade conhecidos, dependendo da especificação do ponto de extremidade do grupo de interface.

Um servidor usa o vetor de identificadores de associação para exportar para o serviço de nome ou para conversão em associações de cadeia de caracteres. Se não houver identificadores de associação (nenhuma sequência de protocolo registrada), RpcServerInterfaceGroupInqBindings retornará RPC_S_NO_BINDINGS e BindingVector será NULL. O servidor é responsável por chamar RpcBindingVectorFree para liberar a memória do vetor.

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

Confira também

RpcServerInterfaceGroupActivate

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate