Compartir a través de

Función PeerGraphEnumRecords (p2p.h)

  • Artículo

La función PeerGraphEnumRecords crea y devuelve un identificador de enumeración utilizado para enumerar registros de un tipo específico de registro, usuario o ambos. Una enumeración proporciona una instantánea de registros en el momento en que se realiza una enumeración.

Sintaxis

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

Parámetros

[in] hGraph

Identificador de un gráfico del mismo nivel.

[in] pRecordType

Puntero al tipo de registro que se va a enumerar. Especifique NULL para enumerar todos los tipos de registro.

[in] pwzPeerId

Puntero a una cadena que identifica al creador para el que una aplicación solicita una enumeración. Especifique NULL para enumerar todos los registros.

[out] phPeerEnum

Recibe un identificador de una enumeración. Proporcione el identificador a todas las llamadas a PeerGraphGetNextItem. Cuando no se necesita un identificador, liberelo llamando a PeerGraphEndEnumeration.

Valor devuelto

Si la llamada de función se realiza correctamente, el valor devuelto es S_OK. De lo contrario, devuelve uno de los valores siguientes.

Código devuelto Descripción
E_INVALIDARG
 Un parámetro no es válido.
E_OUTOFMEMORY
 No hay suficiente memoria para realizar una operación especificada.
PEER_E_INVALID_GRAPH
 El identificador de un gráfico del mismo nivel no es válido.
PEER_E_NOT_INITIALIZED
 Se debe inicializar un grafo con una llamada a PeerGraphStartup antes de usar esta función.

Comentarios

  • Si los parámetros pRecordType y pwzPeerId son NULL, se devuelven todos los registros.
  • Para tareas de enumeración sencillas, use la función PeerGraphEnumRecords , ya que es más eficaz que la función PeerGraphSearchRecords . Para tareas complejas de enumeración y filtrado, como búsquedas heurísticas de la base de datos, use la función PeerGraphSearchRecords .
  • Cuando se llama a PeerGraphGetNextItem con el identificador que PeerGraphEnumRecords devuelve, PeerGraphGetNextItem devuelve los datos de la estructura PEER_RECORD .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado p2p.h
Library P2PGraph.lib
Archivo DLL P2PGraph.dll

Consulte también

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

PeerGraphSearchRecords