PeerCollabExportContact-Funktion (p2p.h)
Die Funktion PeerCollabExportContact exportiert die Kontaktdaten, die einem Peernamen zugeordnet sind, in einen Zeichenfolgenpuffer. Der Puffer enthält Kontaktdaten im XML-Format.
Mit der Funktion PeerCollabAddContact kann diese XML-Zeichenfolge von anderen Peers verwendet werden.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabExportContact(
[in, optional] PCWSTR pwzPeerName,
[out, optional] PWSTR *ppwzContactData
);
Parameter
[in, optional] pwzPeerName
Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Peerkontakts enthält, für den exportiert werden soll.
Wenn dieser Parameter NULL ist, werden die Kontaktinformationen "Me" für den aufrufenden Peer exportiert.
[out, optional] ppwzContactData
Zeiger auf einen Zeichenfolgenpuffer mit Null-Beendigung, der XML-Daten für Peerkontakte enthält, bei denen die Peernamen mit der in pwzPeerName angegebenen Zeichenfolge übereinstimmen.
Der hier zurückgegebene Arbeitsspeicher kann 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 Windows-Peer-Infrastruktur wird nicht initialisiert. Das Aufrufen der entsprechenden Initialisierungsfunktion ist erforderlich. |
|
Eines der Argumente ist ungültig. |
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 |