Compartilhar via


Função PeerGraphSearchRecords (p2p.h)

A função PeerGraphSearchRecords pesquisa o grafo par em busca de registros específicos.

Sintaxe

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

Parâmetros

[in] hGraph

Manipule para o grafo par.

[in] pwzCriteria

Ponteiro para uma cadeia de caracteres XML que especifica os registros a serem pesquisados. Para obter informações sobre como formular uma cadeia de caracteres de consulta XML para pesquisar os registros de grafo de pares, consulte Formato de consulta de pesquisa de registro.

[out] phPeerEnum

Manipule para a enumeração.

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 dos parâmetros não é válido.
E_OUTOFMEMORY
Não há memória suficiente para executar a operação especificada.
PEER_E_INVALID_GRAPH
O identificador para o grafo par é inválido.
PEER_E_INVALID_SEARCH
A consulta especificada não segue o esquema de pesquisa. Consulte Formato de consulta de pesquisa de registro para obter mais informações.
PEER_E_NOT_INITIALIZED
O grafo par deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.

Comentários

A função PeerGraphEnumRecords é mais eficiente do que a função PeerGraphSearchRecords .

Quando PeerGraphGetNextItem é chamado com o identificador retornado por PeerGraphSearchRecords, 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

PeerGraphEnumRecords

PeerGraphGetItemCount

PeerGraphGetNextItem