Funzione PeerCollabEnumObjects (p2p.h)
La funzione PeerCollabEnumObjects restituisce l'handle a un'enumerazione che contiene gli oggetti peer associati all'endpoint di un peer specifico.
Sintassi
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumObjects(
[in] PCPEER_ENDPOINT pcEndpoint,
[in, optional] const GUID *pObjectId,
[out] HPEERENUM *phPeerEnum
);
Parametri
[in] pcEndpoint
Puntatore a una struttura PEER_ENDPOINT che contiene le informazioni sull'endpoint per un peer i cui oggetti verranno enumerati.
Se questo parametro è NULL , vengono restituiti gli oggetti pubblicati dei contatti del peer locale.
[in, optional] pObjectId
Puntatore a un valore GUID che identifica in modo univoco un oggetto peer con il peer fornito. Se questo parametro viene specificato, l'unico oggetto peer restituito è quello corrispondente a questo GUID.
[out] phPeerEnum
Puntatore all'handle per il set enumerato di oggetti peer che corrispondono al GUID restituito in pObjectId. Passare questo handle a PeerGetNextItem per ottenere ogni elemento nel set enumerato.
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.
PeerCollabEnumObjects restituirà tutti gli oggetti pubblicati per il peer locale. Gli oggetti possono essere pubblicati da più di un'applicazione.
Per ottenere i singoli oggetti peer, passare l'handle restituito a PeerGetNextItem. Gli oggetti peer vengono restituiti come matrice di puntatori alle strutture PEER_OBJECT . Se l'endpoint non pubblica alcun oggetto, verrà restituita una matrice vuota. Per chiudere l'enumerazione e rilasciare le risorse associate, passare questo handle a PeerEndEnumeration. I singoli elementi restituiti dall'enumerazione devono essere rilasciati con PeerFreeData.
Per ottenere correttamente un oggetto peer:
- L'endpoint deve essere stato ottenuto in precedenza chiamando PeerCollabEnumEndpoints.
- Il peer locale deve avere sottoscritto l'endpoint chiamando PeerCollabSubscribeEndpointData.
- I dati dell'endpoint devono essere aggiornati chiamando PeerCollabRefreshEndpointData correttamente.
Se l'utente pubblica un'immagine, l'immagine può essere ottenuta recuperando l'oggetto corrispondente. Il GUID per l'oggetto immagine è PEER_COLLAB_OBJECTID_USER_PICTURE.
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 |