Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The PeerGraphGetNodeInfo function retrieves information about a specific node.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetNodeInfo(
[in] HGRAPH hGraph,
[in] ULONGLONG ullNodeId,
[out] PPEER_NODE_INFO *ppNodeInfo
);
Parameters
[in] hGraph
Handle to a peer graph.
[in] ullNodeId
Specifies the ID of a node that an application receives information about. Specify zero (0) to retrieve information about the local node.
[out] ppNodeInfo
Receives a pointer to a PEER_NODE_INFO structure that contains the requested information. When the handle is not needed, free it by calling PeerGraphFreeData.
Return value
If the function succeeds, the return value is S_OK. Otherwise, the function returns one of the following error codes.
| Return code | Description |
|---|---|
|
One parameter is not valid. |
|
There is not enough memory to perform a specified operation. |
|
The handle to a peer graph is invalid. |
|
A peer graph must be initialized by using a call to PeerGraphStartup before using this function. |
|
A specified node is not found. |
Remarks
There can be several nodes of a graph on a computer. For example, multiple users may have joined the graph on a specific computer, so the information that PeerGraphGetNodeInfo returns is about each node—not each computer.
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 |