Função PeerGroupGetRecord (p2p.h)

Artigo
08/25/2023

A função PeerGroupGetRecord recupera um registro de grupo específico.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
  [in]  HGROUP       hGroup,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

Parâmetros

[in] hGroup

Manipule para um grupo que contém um registro específico. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.

[in] pRecordId

Especifica o valor guid que identifica exclusivamente um registro necessário em um grupo de pares. Este parâmetro é necessário.

[out] ppRecord

Ponteiro para o endereço de uma estrutura PEER_RECORD que contém um registro retornado. Essa estrutura é liberada passando seu ponteiro para PeerFreeData. 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 para executar a operação especificada.
PEER_E_GROUP_NOT_READY	O grupo de pares não está em um estado em que os registros de grupo podem ser recuperados. Por exemplo, PeerGroupJoin é chamado, mas a sincronização com o banco de dados de grupo par não foi concluída.
PEER_E_INVALID_GROUP	O identificador para um grupo de pares é inválido.
PEER_E_RECORD_NOT_FOUND	Um registro que corresponde à ID fornecida não pode ser encontrado em um banco de dados de grupo par.

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