Função PeerGroupAddRecord (p2p.h)

Artigo
03/05/2024

A função PeerGroupAddRecord adiciona um novo registro ao grupo de pares, que é propagado para todos os pares participantes.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupAddRecord(
  [in]  HGROUP       hGroup,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Parâmetros

[in] hGroup

Manipule para o grupo de pares. 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 é adicionada ao grupo de pares especificado em hGroup. Este parâmetro é necessário.

Os membros a seguir no PEER_RECORD devem ser preenchidos.

dwSize
tipo
ftExpiration

ftExpiration deve ser expresso como tempo de par (consulte PeerGroupUniversalTimeToPeerTime).

Os membros a seguir são ignorados e substituídos se preenchidos.

id
pwzCreatorId
pwzLastModifiedById
ftCreation
ftLastModified
securityData

Os campos restantes são opcionais.

[out] pRecordId

Ponteiro para um GUID que identifica o registro. Este parâmetro é necessário.

Retornar valor

Retorna S_OK se a funçã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 podem ser adicionados. Por exemplo, PeerGroupJoin é chamado, mas a sincronização com o banco de dados de grupo par não foi concluída.
PEER_E_INVALID_ATTRIBUTES	A cadeia de caracteres XML que contém os atributos de registro no membro pwzAttributes da estrutura PEER_RECORD não está em conformidade com a especificação de esquema.
PEER_E_INVALID_GROUP	O identificador para o grupo de pares é inválido.
PEER_E_INVALID_PEER_NAME	O nome do par fornecido é inválido.
PEER_E_INVALID_RECORD	Um ou mais campos em PEER_RECORD são inválidos.
PEER_E_MAX_RECORD_SIZE_EXCEEDED	O registro excedeu o tamanho máximo permitido pelas propriedades do grupo de pares.
PEER_E_NOT_AUTHORIZED	A identidade não está autorizada a publicar um registro desse tipo.

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

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_RECORD

PeerGroupDeleteRecord

PeerGroupEnumRecords

PeerGroupUpdateRecord

Compartilhar via