PeerCollabGetApplicationRegistrationInfo-Funktion (p2p.h)
Die Funktion PeerCollabGetApplicationRegistrationInfo ruft anwendungsspezifische Registrierungsinformationen ab.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetApplicationRegistrationInfo(
[in] const GUID *pApplicationId,
[in] PEER_APPLICATION_REGISTRATION_TYPE registrationType,
[out] PPEER_APPLICATION_REGISTRATION_INFO *ppApplication
);
Parameter
[in] pApplicationId
Zeiger auf den GUID-Wert, der die Anwendungsregistrierungsflags eines bestimmten Peers darstellt.
[in] registrationType
Ein PEER_APPLICATION_REGISTRATION_TYPE Enumerationswert, der beschreibt, ob die Anwendung des Peers für den aktuellen Benutzer oder für alle Benutzer des lokalen Computers registriert ist.
[out] ppApplication
Zeiger auf die Adresse einer PEER_APPLICATION_REGISTRATION_INFO Struktur, die die Informationen zur spezifischen registrierten Anwendung eines Peers enthält. Die in diesem Parameter zurückgegebenen Daten können durch Aufrufen von PeerFreeData freigegeben werden.
Rückgabewert
Gibt S_OK zurück, wenn die Funktion erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang zu unterstützen. |
|
Eines der Argumente ist ungültig. |
|
Die angeforderte Anwendung ist nicht für den angegebenen registrationType registriert. |
Hinweise
Eine Anwendung besteht aus einer Reihe von Software- oder Softwarefeatures, die auf dem Endpunkt des Peers verfügbar sind. In der Regel bezieht sich dies auf Softwarepakete, die Peernetzwerkaktivitäten unterstützen, z. B. Spiele oder andere gemeinsame Anwendungen.
Die Anwendung eines Peers verfügt über eine GUID, die eine einzelne Anwendung darstellt. Wenn eine Anwendung für einen Peer registriert ist, können diese GUID und die entsprechende Anwendung allen vertrauenswürdigen Kontakten des Peers zur Verfügung gestellt werden, was die Aktivitäten angibt, an denen der Peer teilnehmen kann. Um die Registrierung der Anwendung eines Peers aufzuheben, rufen Sie PeerCollabUnregisterApplication mit dieser GUID auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2P.lib |
| DLL | P2P.dll |
Weitere Informationen
PEER_APPLICATION_REGISTRATION_INFO
PEER_APPLICATION_REGISTRATION_TYPE