Funzione PeerGroupGetRecord (p2p.h)

Articolo
03/15/2023

La funzione PeerGroupGetRecord recupera un record di gruppo specifico.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
  [in]  HGROUP       hGroup,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

Parametri

[in] hGroup

Handle in un gruppo contenente un record specifico. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[in] pRecordId

Specifica il valore GUID che identifica in modo univoco un record obbligatorio all'interno di un gruppo peer. Questo parametro è obbligatorio.

[out] ppRecord

Puntatore all'indirizzo di una struttura PEER_RECORD contenente un record restituito. Questa struttura viene liberata passando il puntatore a PeerFreeData. Questo parametro è obbligatorio.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione specificata.
PEER_E_GROUP_NOT_READY	Il gruppo peer non è in uno stato in cui è possibile recuperare i record di gruppo. Ad esempio, PeerGroupJoin viene chiamato, ma la sincronizzazione con il database del gruppo peer non è stata completata.
PEER_E_INVALID_GROUP	L'handle a un gruppo peer non è valido.
PEER_E_RECORD_NOT_FOUND	Non è possibile trovare un record corrispondente all'ID fornito in un database del gruppo peer.

Gli errori specifici della crittografia possono essere restituiti dal provider di base Microsoft RSA. Questi errori sono preceduti da CRYPT_* e definiti in Winerror.h.

Requisiti


Client minimo supportato	Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll