Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die PeerCollabSignin-Funktion signiert den Peer in einem gehosteten Internet (serverlose Anwesenheit) oder Subnetz ("Personen Near Me") für die Peerzusammenarbeit.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSignin(
[in] HWND hwndParent,
[in] DWORD dwSigninOptions
);
Parameter
[in] hwndParent
Windows-Handle für die Anmeldung der übergeordneten Anwendung.
[in] dwSigninOptions
PEER_SIGNIN_FLAGS Enumerationswert, der die Anmeldeoptionen des Anwesenheitsanbieters für den aufrufenden Peer enthält.
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 Anwendung hat peerCollabStartup zuvor nicht aufgerufen. |
|
Es wurde versucht, PeerCollabSignIn aus einem Prozess mit erhöhten Rechten aufzurufen. |
|
Die Anmeldung war erfolgreich, aber IPv6-Adressen sind derzeit nicht verfügbar. |
Hinweise
Wenn der p2phost.exe Dienst nicht ausgeführt wird, wird er von dieser Funktion gestartet.
Wenn versucht wird, den p2phost.exe-Dienst über einen Prozess mit erhöhten Rechten zu starten, wird ein Fehler zurückgegeben. Daher kann die Sicherheit nicht durch eine Anwendung beeinträchtigt werden, die versehentlich Administratorrechte für p2phost.exe gewährt. Es ist nicht möglich, p2phost.exe in einem nicht interaktiven Modus zu starten, da Windows-Dialogfelder für eingehende Einladungen angezeigt werden müssen.
Beim Aufrufen von PeerCollabSignin wird eine Anmeldebenutzeroberfläche angezeigt, wenn der Benutzer die automatische Anmeldung nicht autorisiert hat. Wenn hwndParent angegeben ist, verwendet das Benutzeroberflächenfenster hwndParent als übergeordnetes Fenster.
Wenn sich ein Benutzer bei "Personen Near Me" anmeldet, werden der Anzeigename, der Computername und die IP-Adresse des Benutzers für Peers im Subnetz veröffentlicht. Der Benutzer kann optional ein Anzeigebild für die Veröffentlichung angeben. Diese Informationen werden nicht veröffentlicht, wenn PeerCollabSignin nicht aufgerufen wird oder sich der Benutzer abmeldet.
Nach der Anmeldung kann der Benutzer eine Liste von Peers anzeigen, die im Subnetz angemeldet sind und für die Interaktion verfügbar sind. Diese Liste ist leer, wenn sich kein anderer Benutzer bei "Personen Near Me" im Subnetz angemeldet hat.
Mehrere Anwendungen können die Infrastruktur jederzeit nutzen. Es wird nicht empfohlen, dass eine einzelne Anwendung PeerCollabSignout aufruft, da andere Anwendungen die Infrastruktur nicht verwenden können. Anwendungen müssen auch darauf vorbereitet sein, dass der Benutzer sich anmeldet und abmeldet, oder Situationen, in denen ein Computer in den Ruhezustand wechselt.
Die Funktion PeerCollabSignin benötigt derzeit bis zu zwei Sekunden.
Anzeigenamen sind nicht unbedingt eindeutig. Benutzer sollten die Identität der Person mithilfe eines Anzeigenamens per E-Mail, Telefon oder persönlich überprüfen, bevor sie eine Einladung zur Interaktion annehmen.
Rufen Sie PeerCollabSignout mit den gleichen Anmeldeoptionen auf, um sich von einem Peer-Netzwerk abzumelden. Ein Benutzer kann sich auch über die Benutzeroberfläche abmelden.
Anforderungen
| 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 |