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 |
---|---|
|
Uno dei parametri non è valido. |
|
Memoria insufficiente per eseguire l'operazione specificata. |
|
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. |
|
L'handle a un gruppo peer non è valido. |
|
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 |