Funzione PeerCollabEnumApplicationRegistrationInfo (p2p.h)

Articolo
03/15/2023

La funzione PeerCollabEnumApplicationRegistrationInfo ottiene l'handle di enumerazione usato per recuperare le informazioni sull'applicazione peer.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplicationRegistrationInfo(
  [in]  PEER_APPLICATION_REGISTRATION_TYPE registrationType,
  [out] HPEERENUM                          *phPeerEnum
);

Parametri

[in] registrationType

Valore PEER_APPLICATION_REGISTRATION_TYPE che specifica se l'applicazione del peer è registrata all'utente corrente o a tutti gli utenti del computer del peer.

[out] phPeerEnum

Puntatore a un handle di enumerazione peer per le informazioni di registrazione dell'applicazione peer. Questi dati vengono ottenuti passando questo handle a PeerGetNextItem.

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_OUTOFMEMORY	Memoria insufficiente per supportare questa operazione.
E_INVALIDARG	Uno degli argomenti non è valido.
PEER_E_NOT_INITIALIZED	L'infrastruttura peer di Windows non viene inizializzata. È necessaria la chiamata alla funzione di inizializzazione pertinente.

Commenti

Per ottenere le singole applicazioni peer, passare l'handle restituito a PeerGetNextItem. Verrà restituita una matrice di strutture PEER_APPLICATION_REGISTRATION_INFO . 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.

Un'applicazione è un set di funzionalità software o software disponibili nell'endpoint del peer. In genere, si riferisce a pacchetti software che supportano attività di rete peer, ad esempio giochi o altre applicazioni collaborative.

Un'applicazione peer ha un GUID che rappresenta una singola applicazione specifica. Quando un'applicazione viene registrata per un peer, questo GUID e l'applicazione corrispondente possono essere resi disponibili a tutti i contatti attendibili del peer, indicando le attività a cui il peer può partecipare. Per annullare la registrazione dell'applicazione di un peer, chiamare PeerCollabUnregisterApplication con questo GUID.

Gli elementi di informazioni di registrazione dell'applicazione peer vengono restituiti come singole strutture di PEER_APPLICATION_REGISTRATION_INFO .

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

Vedi anche

PEER_APPLICATION_REGISTRATION_INFO

PEER_APPLICATION_REGISTRATION_TYPE

Funzioni api di collaborazione peer

PeerCollabUnregisterApplication

Condividi tramite