Compartir a través de

Función PeerGraphSearchRecords (p2p.h)

  • Artículo

La función PeerGraphSearchRecords busca registros específicos en el gráfico del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSearchRecords(
  [in]  HGRAPH    hGraph,
  [in]  PCWSTR    pwzCriteria,
  [out] HPEERENUM *phPeerEnum
);

Parámetros

[in] hGraph

Identificador del gráfico del mismo nivel.

[in] pwzCriteria

Puntero a una cadena XML que especifica los registros que se van a buscar. Para obtener información sobre cómo formular una cadena de consulta XML para buscar los registros de grafos del mismo nivel, vea Formato de consulta de búsqueda de registros.

[out] phPeerEnum

Identificador de la enumeración.

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
 Uno de los parámetros no es válido.
E_OUTOFMEMORY
 No hay suficiente memoria para realizar la operación especificada.
PEER_E_INVALID_GRAPH
 El identificador del grafo del mismo nivel no es válido.
PEER_E_INVALID_SEARCH
 La consulta especificada no cumple el esquema de búsqueda. Consulte Formato de consulta de búsqueda de registros para obtener más información.
PEER_E_NOT_INITIALIZED
 El grafo del mismo nivel debe inicializarse con una llamada a PeerGraphStartup antes de usar esta función.

Comentarios

La función PeerGraphEnumRecords es más eficaz que la función PeerGraphSearchRecords .

Cuando se llama a PeerGraphGetNextItem con el identificador devuelto por PeerGraphSearchRecords, 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

PeerGraphEnumRecords

PeerGraphGetItemCount

PeerGraphGetNextItem