Funzione PeerGroupAddRecord (p2p.h)

Articolo
03/01/2024

La funzione PeerGroupAddRecord aggiunge un nuovo record al gruppo peer, propagato a tutti i peer partecipanti.

Sintassi

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

Parametri

[in] hGroup

Gestire il gruppo peer. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[in] pRecord

Puntatore a una struttura PEER_RECORD aggiunta al gruppo di peer specificato in hGroup. Questo parametro è obbligatorio.

I membri seguenti in PEER_RECORD devono essere popolati.

dwSize
type
ftExpiration

ftExpiration deve essere espresso come tempo peer (vedere PeerGroupUniversalTimeToPeerTime).

I membri seguenti vengono ignorati e sovrascritti se popolati.

id
pwzCreatorId
pwzLastModifiedById
ftCreation
ftLastModified
securityData

Gli altri campi sono facoltativi.

[out] pRecordId

Puntatore a un GUID che identifica il record. Questo parametro è obbligatorio.

Valore restituito

Restituisce S_OK se la funzione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione specificata.
PEER_E_GROUP_NOT_READY	Il gruppo peer non è in uno stato in cui è possibile aggiungere record. Ad esempio, PeerGroupJoin viene chiamato, ma la sincronizzazione con il database del gruppo peer non è stata completata.
PEER_E_INVALID_ATTRIBUTES	La stringa XML che contiene gli attributi di record nel membro pwzAttributes della struttura di PEER_RECORD non è conforme alla specifica dello schema.
PEER_E_INVALID_GROUP	L'handle al gruppo di peer non è valido.
PEER_E_INVALID_PEER_NAME	Il nome del peer specificato non è valido.
PEER_E_INVALID_RECORD	Uno o più campi in PEER_RECORD non sono validi.
PEER_E_MAX_RECORD_SIZE_EXCEEDED	Il record ha superato le dimensioni massime consentite dalle proprietà del gruppo peer.
PEER_E_NOT_AUTHORIZED	L'identità non è autorizzata a pubblicare un record di tale tipo.

Gli errori specifici della crittografia possono essere restituiti dal provider di base Microsoft RSA. Questi errori sono preceduti da CRYPT_* e definiti in Winerror.h.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll

Vedi anche

PEER_RECORD

PeerGroupDeleteRecord

PeerGroupEnumRecords

PeerGroupUpdateRecord

Condividi tramite