Compartilhar via

Função RpcMgmtEpEltInqBegin (rpcdce.h)

  • Artigo

A função RpcMgmtEpEltInqBegin cria um contexto de consulta para exibir os elementos em um mapa de ponto de extremidade.

Sintaxe

RPC_STATUS RpcMgmtEpEltInqBegin(
  RPC_BINDING_HANDLE EpBinding,
  unsigned long      InquiryType,
  RPC_IF_ID          *IfId,
  unsigned long      VersOption,
  UUID               *ObjectUuid,
  RPC_EP_INQ_HANDLE  *InquiryContext
);

Parâmetros

EpBinding

Identificador de associação a um host cujos elementos de mapa de ponto de extremidade devem ser exibidos. Especifique NULL para exibir elementos do host local. Se um identificador de associação for especificado, o UUID do objeto no identificador de associação deverá ser NULL. Se presente, o ponto de extremidade no identificador de associação é ignorado e o ponto de extremidade para o banco de dados mapeador de ponto de extremidade no host especificado é usado.

InquiryType

Valor inteiro que indica o tipo de consulta a ser executada no mapa do ponto de extremidade. Veja a seguir tipos de consulta válidos.

Valor Significado
RPC_C_EP_ALL_ELTS
 Retorna todos os elementos do mapa do ponto de extremidade. Os parâmetros IfId, VersOption e ObjectUuid são ignorados.
RPC_C_EP_MATCH_BY_IF
 Pesquisa no mapa do ponto de extremidade elementos que contêm o identificador de interface especificado pelos valores IfId e VersOption .
RPC_C_EP_MATCH_BY_OBJ
 Pesquisa no mapa do ponto de extremidade elementos que contêm o objeto UUID especificado por ObjectUuid.
RPC_C_EP_MATCH_BY_BOTH
 Pesquisa no mapa do ponto de extremidade elementos que contêm o identificador de interface e o UUID do objeto especificados por IfId, VersOption e ObjectUuid.

IfId

Identificador de interface dos elementos de mapa de ponto de extremidade a serem retornados por RpcMgmtEpEltInqNext. Esse parâmetro só é usado quando InquiryType é RPC_C_EP_MATCH_BY_IF ou RPC_C_EP_MATCH_BY_BOTH. Caso contrário, será ignorada.

VersOption

Especifica como RpcMgmtEpEltInqNext usa o parâmetro IfId . Esse parâmetro só é usado quando InquiryType é RPC_C_EP_MATCH_BY_IF ou RPC_C_EP_MATCH_BY_BOTH. Caso contrário, será ignorada. Veja a seguir valores válidos para esse parâmetro.

Valor Significado
RPC_C_VERS_ALL
 Retorna elementos de mapa de ponto de extremidade que oferecem a interface UUID especificada, independentemente dos números de versão.
RPC_C_VERS_COMPATIBLE
 Retorna elementos de mapa de ponto de extremidade que oferecem a mesma versão principal da interface UUID especificada e uma versão secundária maior ou igual à versão secundária da interface UUID especificada.
RPC_C_VERS_EXACT
 Retorna elementos de mapa de ponto de extremidade que oferecem a versão especificada da interface UUID especificada.
RPC_C_VERS_MAJOR_ONLY
 Retorna elementos de mapa de ponto de extremidade que oferecem a mesma versão principal da interface UUID especificada e ignora a versão secundária.
RPC_C_VERS_UPTO
 Retorna elementos de mapa de ponto de extremidade que oferecem uma versão da interface UUID especificada menor ou igual à versão principal e secundária especificada.

ObjectUuid

O objeto UUID que RpcMgmtEpEltInqNext procura em elementos de mapa de ponto de extremidade. Esse parâmetro é usado somente quando InquiryType é RPC_C_EP_MATCH_BY_OBJ ou RPC_C_EP_MATCH_BY_BOTH.

InquiryContext

Retorna um contexto de consulta para uso com RpcMgmtEpEltInqNext e RpcMgmtEpEltInqDone. Confira RPC_EP_INQ_HANDLE.

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 RpcMgmtEpEltInqBegin cria um contexto de consulta para exibir informações de endereço do servidor armazenadas no mapa do ponto de extremidade. Usando InquiryType e VersOption, um aplicativo especifica quais dos seguintes elementos de mapa de ponto de extremidade devem ser retornados de chamadas para RpcMgmtEpEltInqNext:

  • Todos os elementos
  • Esses elementos com o identificador de interface especificado
  • Esses elementos com o objeto especificado UUID
  • Esses elementos com o identificador de interface especificado e o objeto UUID
Antes de chamar RpcMgmtEpEltInqNext, o aplicativo deve primeiro chamar essa função para criar um contexto de consulta. Depois de exibir os elementos de mapa de ponto de extremidade, o aplicativo chama 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

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext