PeerGraphUpdateRecord, fonction (p2p.h)
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 |
---|---|
|
L’un des paramètres n’est pas valide. |
|
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é. |
|
Le handle du graphe d’homologue n’est pas valide. |
|
Le graphe homologue doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction. |
|
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 |