PeerCollabEnumApplicationRegistrationInfo-Funktion (p2p.h)
Die Funktion PeerCollabEnumApplicationRegistrationInfo ruft das Enumerationshandle ab, das zum Abrufen von Peeranwendungsinformationen verwendet wird.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplicationRegistrationInfo(
[in] PEER_APPLICATION_REGISTRATION_TYPE registrationType,
[out] HPEERENUM *phPeerEnum
);
Parameter
[in] registrationType
Ein PEER_APPLICATION_REGISTRATION_TYPE Wert, der angibt, ob die Anwendung des Peers für den aktuellen Benutzer oder für alle Benutzer des Peercomputers registriert ist.
[out] phPeerEnum
Zeiger auf ein Peerenumerationshandle für die Registrierungsinformationen der Peeranwendung. Diese Daten werden abgerufen, indem dieses Handle an PeerGetNextItem übergeben wird.
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 Windows-Peerinfrastruktur wird nicht initialisiert. Der Aufruf der relevanten Initialisierungsfunktion ist erforderlich. |
Hinweise
Um die einzelnen Peeranwendungen abzurufen, übergeben Sie das zurückgegebene Handle an PeerGetNextItem. Ein Array von PEER_APPLICATION_REGISTRATION_INFO Strukturen wird zurückgegeben. Um die Enumeration zu schließen und die zugeordneten Ressourcen freizugeben, übergeben Sie dieses Handle an PeerEndEnumeration. Einzelne elemente, die von der Enumeration zurückgegeben werden, müssen mit PeerFreeData freigegeben werden.
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 spezifische 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.
Registrierungselemente für Peeranwendungen werden als einzelne PEER_APPLICATION_REGISTRATION_INFO-Strukturen zurückgegeben.
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