PeerGroupGetRecord-Funktion (p2p.h)
Die PeerGroupGetRecord-Funktion ruft einen bestimmten Gruppendatensatz ab.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
[in] HGROUP hGroup,
[in] const GUID *pRecordId,
[out] PPEER_RECORD *ppRecord
);
Parameter
[in] hGroup
Handle für eine Gruppe, die einen bestimmten Datensatz enthält. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.
[in] pRecordId
Gibt den GUID-Wert an, der einen erforderlichen Datensatz innerhalb einer Peergruppe eindeutig identifiziert. Dieser Parameter ist erforderlich.
[out] ppRecord
Zeiger auf die Adresse einer PEER_RECORD-Struktur , die einen zurückgegebenen Datensatz enthält. Diese Struktur wird freigegeben, indem der Zeiger an PeerFreeData übergeben wird. Dieser Parameter ist erforderlich.
Rückgabewert
Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Einer der Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen. |
|
Die Peergruppe befindet sich nicht in einem Zustand, in dem Gruppendatensätze abgerufen werden können. Beispielsweise wird PeerGroupJoin aufgerufen, aber die Synchronisierung mit der Peergruppendatenbank wurde nicht abgeschlossen. |
|
Das Handle für eine Peergruppe ist ungültig. |
|
Ein Datensatz, der der angegebenen ID entspricht, kann nicht in einer Peergruppendatenbank gefunden werden. |
Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2P.lib |
| DLL | P2P.dll |