Função RpcNsEntryObjectInqNext (rpcnsi.h)

  • Artigo

A função RpcNsEntryObjectInqNext retorna um objeto por vez de uma entrada de banco de dados name-service.

Nota Essa função não tem suporte no Windows Vista e em sistemas operacionais posteriores.
 

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
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_NO_MORE_MEMBERS
 Não há mais membros.
RPC_S_INCOMPLETE_NAME
 O nome está incompleto.
RPC_S_ENTRY_NOT_FOUND
 A entrada nome-serviço não foi encontrada.
RPC_S_NAME_SERVICE_UNAVAILABLE
 O serviço de nome está indisponível.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

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

Confira também

RpcNsBindingExport

RpcNsEntryObjectInqBegin

RpcNsEntryObjectInqDone