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 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 |