Função PeerGroupSearchRecords (p2p.h)

Artigo
08/25/2023

A função PeerGroupSearchRecords pesquisa o banco de dados de grupo par local em busca de registros que correspondam aos critérios fornecidos.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSearchRecords(
  [in]  HGROUP    hGroup,
  [in]  PCWSTR    pwzCriteria,
  [out] HPEERENUM *phPeerEnum
);

Parâmetros

[in] hGroup

Manipule para o grupo de pares cujo banco de dados local é pesquisado. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.

[in] pwzCriteria

Ponteiro para uma cadeia de caracteres XML Unicode que contém a consulta de pesquisa de registro. Para obter informações sobre como formular uma cadeia de caracteres de consulta XML para pesquisar o banco de dados de registros de grupo par, consulte a documentação Formato de Consulta de Pesquisa de Registros . Este parâmetro é necessário.

[out] phPeerEnum

Ponteiro para a enumeração que contém a lista de registros retornada. Esse identificador é passado para
PeerGetNextItem para recuperar os itens com cada item representado como um ponteiro para uma estrutura PEER_RECORD . Quando concluído, PeerEndEnumeration é chamado para retornar a memória usada pela enumeração . Este parâmetro é necessário.

Valor retornado

Retorna S_OK se a operação for bem-sucedida. Caso contrário, a função 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 disponível para concluir a operação.
PEER_E_INVALID_SEARCH	A consulta de pesquisa XML não segue a especificação do esquema de consulta de pesquisa.

Erros específicos de criptografia podem ser retornados do Provedor Base do Microsoft RSA. Esses erros são prefixados com CRYPT_* e definidos em Winerror.h.

Requisitos


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	P2P.lib
DLL	P2P.dll