PeerCollabGetContact-Funktion (p2p.h)
Die Funktion PeerCollabGetContact ruft die Informationen für einen Peerkontakt unter Angabe des Peernamens des Kontakts ab.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetContact(
[in, optional] PCWSTR pwzPeerName,
[out, optional] PPEER_CONTACT *ppContact
);
Parameter
[in, optional] pwzPeerName
Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Peerkontakts enthält, für den Informationen abgerufen werden sollen.
Wenn dieser Parameter NULL ist, werden die Ich-Kontaktinformationen für den aufrufenden Peer zurückgegeben.
[out, optional] ppContact
Zeiger auf einen Zeiger auf eine PEER_CONTACT-Struktur . Es empfängt die Adresse einer PEER_CONTACT-Struktur, die Peerkontaktinformationen für den peer-Namen enthält, der in pwzPeerName angegeben wird. Wenn dieser Parameter NULL ist, gibt diese Funktion E_INVALIDARG zurück.
Rufen Sie PeerFreeData für die Adresse der PEER_CONTACT-Struktur auf, um diese Daten frei zu geben.
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. |
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 |