Compartilhar via


Função PeerGroupUpdateRecord (p2p.h)

A função PeerGroupUpdateRecord atualiza um registro dentro de um grupo de pares específico.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupUpdateRecord(
  [in] HGROUP       hGroup,
  [in] PPEER_RECORD pRecord
);

Parâmetros

[in] hGroup

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

[in] pRecord

Ponteiro para uma estrutura de PEER_RECORD que contém o registro atualizado para hGroup. Este parâmetro é necessário.

Os membros a seguir no PEER_RECORD podem ser atualizados.

  • pwzAttributes
  • ftExpiration
  • data
Os membros a seguir no PEER_RECORD devem estar presentes, mas não podem ser alterados.
  • dwSize
  • id
  • tipo
  • dwFlags
Os membros a seguir são ignorados se preenchidos.
  • Dwversion
  • pwzCreatorId
  • pwzModifiedById
  • ftCreation
  • ftLastModified
  • securityData
Os membros que permanecem são opcionais.

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 especificados é inválido.
PEER_E_GROUP_NOT_READY
O grupo de pares não está em um estado em que um registro pode ser atualizado, 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_NOT_AUTHORIZED
A identidade de par atual não tem autorização para excluir o registro. Nesse caso, a identidade do par não é o criador do registro.
PEER_E_RECORD_NOT_FOUND
O registro não pode ser localizado no armazenamento de dados.
 

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

PEER_RECORD

PeerGroupAddRecord

PeerGroupCreate

PeerGroupDeleteRecord

PeerGroupJoin

PeerGroupOpen