Función RpcNsEntryObjectInqNext (rpcnsi.h)

  • Artículo

La función RpcNsEntryObjectInqNext devuelve un objeto a la vez desde una entrada de base de datos de servicio de nombres.

Nota Esta función no se admite en Windows Vista ni en sistemas operativos posteriores.
 

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
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_NO_MORE_MEMBERS
 No más miembros.
RPC_S_INCOMPLETE_NAME
 El nombre está incompleto.
RPC_S_ENTRY_NOT_FOUND
 No se encontró la entrada name-service.
RPC_S_NAME_SERVICE_UNAVAILABLE
 El nombre del servicio no está disponible.
 
Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.
 

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

Consulte también

RpcNsBindingExport

RpcNsEntryObjectInqBegin

RpcNsEntryObjectInqDone