Función RpcMgmtEpEltInqBegin (rpcdce.h)

  • Artículo

La función RpcMgmtEpEltInqBegin crea un contexto de consulta para ver los elementos en un mapa de punto de conexión.

Sintaxis

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 enlace a un host cuyos elementos de mapa de punto de conexión se van a ver. Especifique NULL para ver los elementos del host local. Si se especifica un identificador de enlace, el UUID de objeto en el identificador de enlace debe ser NULL. Si está presente, se omite el punto de conexión del identificador de enlace y se usa el punto de conexión a la base de datos del asignador de puntos de conexión en el host determinado.

InquiryType

Valor entero que indica el tipo de consulta que se va a realizar en el mapa del punto de conexión. Los siguientes son tipos de consulta válidos.

Valor Significado
RPC_C_EP_ALL_ELTS
 Devuelve todos los elementos del mapa del punto de conexión. Se omiten los parámetros IfId, VersOption y ObjectUuid .
RPC_C_EP_MATCH_BY_IF
 Busca en el mapa de puntos de conexión los elementos que contienen el identificador de interfaz especificado por los valores IfId y VersOption .
RPC_C_EP_MATCH_BY_OBJ
 Busca en el mapa de puntos de conexión los elementos que contienen el UUID de objeto especificado por ObjectUuid.
RPC_C_EP_MATCH_BY_BOTH
 Busca en el mapa de puntos de conexión los elementos que contienen el identificador de interfaz y el UUID de objeto especificados por IfId, VersOption y ObjectUuid.

IfId

Identificador de interfaz de los elementos de mapa de punto de conexión que rpcMgmtEpEltInqNext va a devolver. Este parámetro solo se usa cuando InquiryType es RPC_C_EP_MATCH_BY_IF o RPC_C_EP_MATCH_BY_BOTH. De lo contrario, se omite.

VersOption

Especifica cómo RpcMgmtEpEltInqNext usa el parámetro IfId . Este parámetro solo se usa cuando InquiryType es RPC_C_EP_MATCH_BY_IF o RPC_C_EP_MATCH_BY_BOTH. De lo contrario, se omite. Los siguientes son valores válidos para este parámetro.

Valor Significado
RPC_C_VERS_ALL
 Devuelve elementos de mapa de punto de conexión que ofrecen el UUID de interfaz especificado, independientemente de los números de versión.
RPC_C_VERS_COMPATIBLE
 Devuelve elementos de mapa de punto de conexión que ofrecen la misma versión principal del UUID de interfaz especificado y una versión secundaria mayor o igual que la versión secundaria del UUID de interfaz especificado.
RPC_C_VERS_EXACT
 Devuelve elementos de mapa de punto de conexión que ofrecen la versión especificada del UUID de interfaz especificado.
RPC_C_VERS_MAJOR_ONLY
 Devuelve elementos de mapa de punto de conexión que ofrecen la misma versión principal del UUID de interfaz especificado y omite la versión secundaria.
RPC_C_VERS_UPTO
 Devuelve elementos de mapa de punto de conexión que ofrecen una versión del UUID de interfaz especificado menor o igual que la versión principal y secundaria especificada.

ObjectUuid

El UUID de objeto que RpcMgmtEpEltInqNext busca en los elementos de mapa de punto de conexión. Este parámetro solo se usa cuando InquiryType es RPC_C_EP_MATCH_BY_OBJ o RPC_C_EP_MATCH_BY_BOTH.

InquiryContext

Devuelve un contexto de consulta para su uso con RpcMgmtEpEltInqNext y RpcMgmtEpEltInqDone. Consulte RPC_EP_INQ_HANDLE.

Valor devuelto

Valor Significado
RPC_S_OK
 La llamada se realizó correctamente.
 
Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.
 

Comentarios

La función RpcMgmtEpEltInqBegin crea un contexto de consulta para ver la información de dirección del servidor almacenada en el mapa del punto de conexión. Mediante InquiryType y VersOption, una aplicación especifica cuáles de los siguientes elementos de mapa de punto de conexión se van a devolver desde llamadas a RpcMgmtEpEltInqNext:

  • Todos los elementos
  • Esos elementos con el identificador de interfaz especificado
  • Esos elementos con el UUID del objeto especificado
  • Esos elementos con el identificador de interfaz y el UUID de objeto especificados
Antes de llamar a RpcMgmtEpEltInqNext, la aplicación primero debe llamar a esta función para crear un contexto de consulta. Después de ver los elementos de mapa de punto de conexión, la aplicación llama a RpcMgmtEpEltInqDone para eliminar el contexto de consulta.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RpcEpRegister

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext