Condividi tramite


Funzione PeerGroupGetRecord (p2p.h)

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

Vedi anche

PEER_RECORD

PeerFreeData

PeerGroupCreate

PeerGroupDeleteRecord

PeerGroupEnumRecords

PeerGroupJoin

PeerGroupOpen