Compartilhar via

Função PeerGroupSetProperties (p2p.h)

  • Artigo

A função PeerGroupSetProperties define as propriedades atuais do grupo de pares. Na versão 1.0 dessa API, somente o criador do grupo par pode executar essa operação.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSetProperties(
  [in] HGROUP                 hGroup,
  [in] PPEER_GROUP_PROPERTIES pProperties
);

Parâmetros

[in] hGroup

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

[in] pProperties

Ponteiro para uma estrutura de PEER_GROUP_PROPERTIES populada por pares que contém as novas propriedades. Para obter essa estrutura, um par deve primeiro chamar PeerGroupGetProperties, alterar os campos apropriados e, em seguida, passá-lo como esse parâmetro. Este parâmetro é necessário.

Os seguintes membros do PEER_GROUP_PROPERTIES não podem ser alterados:

  • dwSize
  • pwzCloud
  • pwzClassifier
  • pwzGroupPeerName
  • pwzCreatorPeerName

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_OUTOFMEMORY
 Não há memória suficiente disponível para concluir a operação.
PEER_E_GROUP_NOT_READY
 O grupo não está em um estado em que as propriedades do grupo de pares podem ser definidas. Por exemplo, PeerGroupJoin foi chamado, mas a sincronização com o banco de dados de grupo par não está concluída.
PEER_E_INVALID_GROUP
 O identificador para o grupo de pares é inválido.
PEER_E_INVALID_GROUP_PROPERTIES
 Uma ou mais das propriedades especificadas são inválidas.
PEER_E_NOT_AUTHORIZED
 A identidade atual não tem autorização para alterar essas propriedades. Nesse caso, a identidade não é o criador do grupo de pares.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY
 A senha especificada não atende aos requisitos de senha do sistema.
 

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

Para aplicativos que utilizam senhas, é recomendável que as senhas sejam tratadas com segurança chamando as funções CryptoProtectMemory e SecureZeroMemory .

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

Confira também

PEER_GROUP_PROPERTIES

PeerGroupCreate

PeerGroupGetProperties

PeerGroupJoin

PeerGroupOpen