PeerGraphSetProperties function (p2p.h)

The PeerGraphSetProperties function sets the peer graph properties.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSetProperties(
  [in] HGRAPH                 hGraph,
  [in] PPEER_GRAPH_PROPERTIES pGraphProperties
);

Parameters

[in] hGraph

Handle to a graph.

[in] pGraphProperties

Pointer to a PEER_GRAPH_PROPERTIES structure that specifies new values for the graph properties that an application can set.

An application can set only the following fields of PEER_GRAPH_PROPERTIES:

  • pwzFriendlyName
  • cPresenceMax
  • pwzComment
  • ulPresenceLifetime
Note   If remaining fields are set, then they are ignored.
 

Return value

If the function call succeeds, the return value is S_OK. Otherwise, it returns one of the following values.

Return code Description
E_ACCESSDENIED
Cannot access a peer graph.
E_INVALIDARG
One of the parameters is not valid.
PEER_E_INVALID_GRAPH
The handle to a peer graph is invalid.
PEER_E_NOT_INITIALIZED
The graph must be initialized with a call to PeerGraphStartup before using this function.

Remarks

You can modify the pwzFriendlyName, cPresenceMax, pwzComment and ulPresenceLifetime members of the PEER_GRAPH_PROPERTIES structure.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2 [desktop apps only],Windows XP with SP1 with the Advanced Networking Pack forWindows XP
Minimum supported server None supported
Target Platform Windows
Header p2p.h
Library P2PGraph.lib
DLL P2PGraph.dll

See also

PEER_GRAPH_PROPERTIES

PeerGraphCreate

PeerGraphGetProperties