Compartilhar via

Função PeerGraphEnumRecords (p2p.h)

  • Artigo

A função PeerGraphEnumRecords cria e retorna um identificador de enumeração usado para enumerar registros de um tipo específico de registro, usuário ou ambos. Uma enumeração fornece uma instantâneo de registros no momento em que uma enumeração é executada.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumRecords(
  [in]  HGRAPH     hGraph,
  [in]  const GUID *pRecordType,
  [in]  PCWSTR     pwzPeerId,
  [out] HPEERENUM  *phPeerEnum
);

Parâmetros

[in] hGraph

Identificador para um grafo par.

[in] pRecordType

Ponteiro para o tipo de registro a ser enumerado. Especifique NULL para enumerar todos os tipos de registro.

[in] pwzPeerId

Ponteiro para uma cadeia de caracteres que identifica o criador para o qual um aplicativo está solicitando uma enumeração. Especifique NULL para enumerar todos os registros.

[out] phPeerEnum

Recebe um identificador para uma enumeração. Forneça o identificador para todas as chamadas para PeerGraphGetNextItem. Quando um identificador não for necessário, libere-o chamando PeerGraphEndEnumeration.

Retornar valor

Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará um dos valores a seguir.

Código de retorno Descrição
E_INVALIDARG
 Um parâmetro não é válido.
E_OUTOFMEMORY
 Não há memória suficiente para executar uma operação especificada.
PEER_E_INVALID_GRAPH
 O identificador para um grafo par é inválido.
PEER_E_NOT_INITIALIZED
 Um grafo deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.

Comentários

  • Se os parâmetros pRecordType e pwzPeerId forem NULL, todos os registros serão retornados.
  • Para tarefas de enumeração simples, use a função PeerGraphEnumRecords , pois ela é mais eficiente do que a função PeerGraphSearchRecords . Para tarefas complexas de enumeração e filtragem, como pesquisas heurísticas do banco de dados, use a função PeerGraphSearchRecords .
  • Quando PeerGraphGetNextItem é chamado com o identificador que PeerGraphEnumRecords retorna, PeerGraphGetNextItem retorna os dados na estrutura PEER_RECORD .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho p2p.h
Biblioteca P2PGraph.lib
DLL P2PGraph.dll

Confira também

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

PeerGraphSearchRecords