Compartilhar via


Função PeerGroupSearchRecords (p2p.h)

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

Confira também

PeerEndEnumeration

PeerGetNextItem

PeerGroupCreate

PeerGroupJoin

PeerGroupOpen

Formato de consulta de pesquisa de registro