Funzione PeerCollabRegisterApplication (p2p.h)

La funzione PeerCollabRegisterApplication registra un'applicazione con il computer locale in modo che possa essere avviata in un'attività di collaborazione peer.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterApplication(
  [in] PCPEER_APPLICATION_REGISTRATION_INFO pcApplication,
  [in] PEER_APPLICATION_REGISTRATION_TYPE   registrationType
);

Parametri

[in] pcApplication

Puntatore a una struttura PEER_APPLICATION_REGISTRATION_INFO che contiene l'UUID del set di funzionalità dell'applicazione del peer, nonché eventuali dati aggiuntivi specifici del peer.

[in] registrationType

Valore PEER_APPLICATION_REGISTRATION_TYPE che descrive se l'applicazione del peer è registrata all'utente corrente o a tutti gli utenti del computer del 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
E_OUTOFMEMORY	Memoria insufficiente per supportare questa operazione.
E_INVALIDARG	Uno degli argomenti non è valido.

Commenti

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.

L'infrastruttura di collaborazione può ricevere inviti dell'applicazione da contatti attendibili o da "Persone Near Me", che si basano sull'ambito in cui l'infrastruttura di collaborazione è connesso con l'uso di PeerCollabSignin.

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.

Quando si registra un'applicazione, è consigliabile che gli sviluppatori specifichino un percorso relativo, ad esempio %ProgramFiles%, anziché un percorso assoluto. Ciò impedisce l'errore dell'applicazione a causa di una modifica nel percorso dei file dell'applicazione. Ad esempio, se la directory C:\ProgramFiles viene spostata in E:\.

È possibile registrare solo le applicazioni locali del computer. Non è possibile eseguire la registrazione quando il percorso eseguibile di un'applicazione si trova in una condivisione di rete, ad esempio un percorso UNC o un'unità di rete mappata localmente.

Le applicazioni possono essere registrate negli ambiti "ALL_USERS" e "CURRENT_USER". Nel caso in cui un'applicazione sia registrata contemporaneamente in entrambi gli ambiti, un'applicazione registrata nell'ambito "CURRENT_USER" ha la precedenza su un'applicazione registrata nell'ambito "ALL_USERS". È importante notare che per registrarsi per il tipo di registrazione "ALL_USERS" il chiamante deve operare con privilegi amministrativi.

Il numero massimo di applicazioni che è possibile registrare per un registrationType specifico è 64.

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_TYPE

Funzioni api di collaborazione peer

PeerCollabUnregisterApplication