Compartilhar via

Função RpcMgmtEpEltInqNext (rpcdce.h)

  • Artigo

A função RpcMgmtEpEltInqNext retorna um elemento de um mapa de ponto de extremidade.

Sintaxe

RPC_STATUS RpcMgmtEpEltInqNext(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  RPC_CSTR           *Annotation
);

Parâmetros

InquiryContext

Especifica um contexto de consulta. O contexto de consulta é retornado de RpcMgmtEpEltInqBegin.

IfId

Retorna o identificador de interface do elemento endpoint-map.

Binding

Opcional. Retorna o identificador de associação do elemento endpoint-map.

Annotation

Opcional. Retorna a cadeia de caracteres de anotação para o elemento endpoint-map. Quando não há nenhuma cadeia de caracteres de anotação no elemento endpoint-map, a cadeia de caracteres vazia ("") é retornada.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

A função RpcMgmtEpEltInqNext retorna um elemento do mapa do ponto de extremidade. Os elementos selecionados dependem do contexto de consulta. Os critérios de seleção são determinados por InquiryType da função RpcMgmtEpEltInqBegin que retornou InquiryContext.

Um aplicativo pode exibir todos os elementos de mapa de ponto de extremidade selecionados chamando repetidamente RpcMgmtEpEltInqNext. Quando todos os elementos tiverem sido exibidos, essa função retornará um RPC_X_NO_MORE_ENTRIES status. Os elementos retornados não são ordenados.

Quando os respectivos argumentos não são NULL, a biblioteca de funções de tempo de execução RPC aloca memória para Associação e Anotação em cada chamada para essa função. O aplicativo é responsável por chamar RpcBindingFree para cada Binding e RpcStringFree retornados para cada Anotação retornada.

Depois de exibir os elementos do mapa de ponto de extremidade, o aplicativo deve chamar RpcMgmtEpEltInqDone para excluir o contexto de consulta.

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

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone