PeerGraphUpdateRecord, fonction (p2p.h)

  • Article

La fonction PeerGraphUpdateRecord met à jour un enregistrement dans le graphe homologue, puis inonde l’enregistrement à chaque nœud du graphe homologue.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphUpdateRecord(
  [in] HGRAPH       hGraph,
  [in] PPEER_RECORD pRecord
);

Paramètres

[in] hGraph

Gérez le graphe d’homologue.

[in] pRecord

Pointeur vers une structure de PEER_RECORD qui contient les nouvelles données de l’enregistrement.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il retourne l’une des valeurs suivantes.

Code de retour Description
E_INVALIDARG
 L’un des paramètres n’est pas valide.
PEER_E_GRAPH_NOT_READY
 Le graphe d’homologue n’a jamais été synchronisé. Les enregistrements ne peuvent pas être mis à jour tant que le graphique n’a pas été synchronisé.
PEER_E_INVALID_GRAPH
 Le handle du graphe d’homologue n’est pas valide.
PEER_E_NOT_INITIALIZED
 Le graphe homologue doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.
PEER_E_RECORD_NOT_FOUND
 L’enregistrement spécifié est introuvable.

Notes

Les membres suivants de la structure PEER_RECORD peuvent être modifiés :

  • pwzAttributes
  • ftExpiration : l’expiration ne peut être augmentée que
  • data
  • pwzLastModified : renseigné par défaut si aucune valeur n’est fournie

Exemples

Cet extrait de code montre comment mettre à jour un enregistrement.

// dwFlags is updated to automatically refresh the record if it is about to expire.
    record.dwFlags = PEER_RECORD_FLAG_AUTOREFRESH;
    // The record data is updated with the string contained in pwzUserData.
    record.data.cbData = (ULONG) wcslen(pwzUserData) * sizeof(WCHAR);
    record.data.pbData = (PBYTE) pwzUserData;

    HRESULT hr = PeerGraphUpdateRecord(hGraph, &record;);

    if (FAILED(hr))
    {
        // Insert your code to handle the error here.
    }
    else
    {
        // Insert your application specific code here.
    }

Spécifications

   
Client minimal pris en charge Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack réseau avancé pourWindows XP
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête p2p.h
Bibliothèque P2PGraph.lib
DLL P2PGraph.dll

Voir aussi

PEER_RECORD