Função RpcNsEntryObjectInqNext (rpcnsi.h)
A função RpcNsEntryObjectInqNext retorna um objeto por vez de uma entrada de banco de dados name-service.
Sintaxe
RPC_STATUS RpcNsEntryObjectInqNext(
RPC_NS_HANDLE InquiryContext,
UUID *ObjUuid
);
Parâmetros
InquiryContext
Identificador de nome-serviço que indica as UUIDs de objeto para uma entrada de banco de dados name-service.
ObjUuid
Retorna um ponteiro para um objeto exportado UUID.
Valor retornado
| Valor | Significado |
|---|---|
|
A chamada foi bem-sucedida. |
|
Não há mais membros. |
|
O nome está incompleto. |
|
A entrada nome-serviço não foi encontrada. |
|
O serviço de nome está indisponível. |
Comentários
A função RpcNsEntryObjectInqNext retorna um dos UUIDs de objeto exportados para a entrada de banco de dados name-service especificada pelo parâmetro EntryName na função RpcNsEntryObjectInqBegin .
Um aplicativo pode exibir todos os UUIDs do objeto exportado chamando repetidamente RpcNsEntryObjectInqNext. Quando todos os UUIDs de objeto tiverem sido exibidos, essa função retornará um código RPC_S_NO_MORE_MEMBERS status. Os UUIDs do objeto retornado não são ordenados.
O aplicativo fornece a memória para o objeto UUID retornado no parâmetro ObjUuid .
Depois de exibir os UUIDs do objeto, o aplicativo deve chamar a função RpcNsEntryObjectInqDone para liberar o contexto de consulta.
A ordem na qual UUIDs de objeto são retornadas pode ser diferente para cada exibição de uma entrada. Isso significa que a ordem na qual UUIDs de objeto são retornadas a um aplicativo pode ser diferente sempre que o aplicativo é executado.
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 | rpcnsi.h (inclua Rpc.h) |
| Biblioteca | Rpcns4.lib |
| DLL | Rpcns4.dll |