Funzione PeerCollabEnumApplications (p2p.h)
La funzione PeerCollabEnumApplications restituisce l'handle a un'enumerazione che contiene le applicazioni registrate negli endpoint di un peer specifico.
Sintassi
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplications(
[in, optional] PCPEER_ENDPOINT pcEndpoint,
[in, optional] const GUID *pApplicationId,
[out] HPEERENUM *phPeerEnum
);
Parametri
[in, optional] pcEndpoint
Puntatore a una struttura PEER_ENDPOINT che contiene le informazioni sull'endpoint per un peer le cui applicazioni verranno enumerate.
Se questo parametro è impostato su NULL, vengono enumerate le informazioni sull'applicazione pubblicate per l'endpoint del peer locale.
[in, optional] pApplicationId
Puntatore al valore GUID che identifica in modo univoco una determinata applicazione del peer fornito. Se questo parametro viene specificato, l'unica applicazione peer restituita è quella corrispondente a questo GUID.
[out] phPeerEnum
Puntatore all'handle per il set enumerato di applicazioni registrate 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. |
Commenti
Per enumerare correttamente le applicazioni per l'endpoint specificato, i dati dell'applicazione devono essere disponibili nell'endpoint. Affinché i dati dell'applicazione siano disponibili, è necessario eseguire una delle operazioni seguenti:
- 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.
Per ottenere le singole applicazioni peer, passare l'handle restituito a PeerGetNextItem. 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.
Gli elementi di dati dell'applicazione peer vengono restituiti come singole strutture di PEER_APPLICATION .
La funzione PeerCollabEnumApplications restituisce una matrice vuota per gli endpoint nella subnet che non sono contatti attendibili.
Requisiti
| 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 |