Función RpcNsEntryObjectInqNext (rpcnsi.h)
La función RpcNsEntryObjectInqNext devuelve un objeto a la vez desde una entrada de base de datos de servicio de nombres.
Sintaxis
RPC_STATUS RpcNsEntryObjectInqNext(
RPC_NS_HANDLE InquiryContext,
UUID *ObjUuid
);
Parámetros
InquiryContext
Identificador de servicio de nombres que indica los UUID de objeto para una entrada de base de datos de servicio de nombres.
ObjUuid
Devuelve un puntero a un UUID de objeto exportado.
Valor devuelto
| Valor | Significado |
|---|---|
|
La llamada se realizó correctamente. |
|
No más miembros. |
|
El nombre está incompleto. |
|
No se encontró la entrada name-service. |
|
El nombre del servicio no está disponible. |
Comentarios
La función RpcNsEntryObjectInqNext devuelve uno de los UUID de objeto exportados a la entrada de base de datos name-service especificada por el parámetro EntryName en la función RpcNsEntryObjectInqBegin .
Una aplicación puede ver todos los UUID del objeto exportado llamando repetidamente a RpcNsEntryObjectInqNext. Cuando se han visto todos los UUID de objeto, esta función devuelve un código de estado RPC_S_NO_MORE_MEMBERS. Los UUID de objeto devueltos no están ordenados.
La aplicación proporciona la memoria para el UUID de objeto devuelto en el parámetro ObjUuid .
Después de ver los UUID del objeto, la aplicación debe llamar a la función RpcNsEntryObjectInqDone para liberar el contexto de consulta.
El orden en que se devuelven los UUID de objeto puede ser diferente para cada visualización de una entrada. Esto significa que el orden en el que se devuelven los UUID de objeto a una aplicación puede ser diferente cada vez que se ejecuta la aplicación.
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 | rpcnsi.h (incluir Rpc.h) |
| Library | Rpcns4.lib |
| Archivo DLL | Rpcns4.dll |