Função PeerGroupGetProperties (p2p.h)

Artigo
03/01/2024

A função PeerGroupGetProperties recupera informações sobre as propriedades de um grupo especificado.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
  [in]  HGROUP                 hGroup,
  [out] PPEER_GROUP_PROPERTIES *ppProperties
);

Parâmetros

[in] hGroup

Manipule para um grupo de pares cujas propriedades são recuperadas. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.

[out] ppProperties

Ponteiro para uma estrutura PEER_GROUP_PROPERTIES que contém informações sobre as propriedades do grupo de pares. Esses dados devem ser liberados com PeerFreeData. Este parâmetro é necessário.

Retornar valor

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 uma operação especificada.
PEER_E_GROUP_NOT_READY	O grupo não está em um estado em que as propriedades do grupo de pares podem ser recuperadas. Por exemplo, PeerGroupJoin é chamado, mas a sincronização com o banco de dados de grupo não foi concluída.
PEER_E_INVALID_GROUP	O identificador para o grupo de pares é inválido.

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.

Comentários

As propriedades de grupo não poderão ser recuperadas se um par não tiver sido sincronizado com um banco de dados de grupo par. Para sincronizar com um banco de dados de grupo par antes de chamar essa função, primeiro chame PeerGroupConnect.

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