Funzione PeerCollabSetObject (p2p.h)
La funzione PeerCollabSetObject crea o aggiorna un oggetto dati peer usato in una rete di collaborazione peer.
Sintassi
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
[in] PCPEER_OBJECT pcObject
);
Parametri
[in] pcObject
Puntatore a una struttura PEER_OBJECT che contiene l'oggetto peer nella rete di collaborazione peer.
Valore restituito
Restituisce S_OK se la funzione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Memoria insufficiente per supportare questa operazione. |
|
Uno degli argomenti non è valido. |
|
L'infrastruttura peer di Windows non viene inizializzata. È necessaria la chiamata alla funzione di inizializzazione pertinente. |
|
Per l'operazione è necessario che l'utente sia connesso. |
Commenti
Gli oggetti peer sono elementi di dati in fase di esecuzione associati a una determinata applicazione, ad esempio un'immagine, un avatar, un certificato o una descrizione specifica. Ogni oggetto peer deve essere di dimensioni inferiori a 16.000 e non può essere 0.
Se un oggetto è già pubblicato, PeerCollabSetObject aggiornerà i dati dell'oggetto esistente. L'ultima applicazione che aggiorna l'oggetto assumerà la proprietà dell'oggetto. Di conseguenza, se l'applicazione viene terminata, l'oggetto viene eliminato.
Se lo stato "pubblicato" di un oggetto viene rimosso a causa della disconnessura anziché della chiusura dell'applicazione associata, l'applicazione è responsabile della pubblicazione dell'oggetto alla successiva accesso dell'utente.
I contatti attendibili che guardano questo oggetto peer avranno un evento PEER_EVENT_OBJECT_CHANGED generato localmente, segnalando la modifica dello stato dell'oggetto peer.
PeerCollabSetObject può essere usato per pubblicare al massimo 128 oggetti.
Esiste un oggetto con un DETERMINATO GUID pubblicato in qualsiasi momento.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | p2p.h |
| Libreria | P2P.lib |
| DLL | P2P.dll |