Función RpcMgmtEpEltInqBegin (rpcdce.h)
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.
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 |
---|---|
|
Devuelve elementos de mapa de punto de conexión que ofrecen el UUID de interfaz especificado, independientemente de los números de versión. |
|
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. |
|
Devuelve elementos de mapa de punto de conexión que ofrecen la versión especificada del UUID de interfaz especificado. |
|
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. |
|
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 |
---|---|
|
La llamada se realizó correctamente. |
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
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 |