PeerGraphValidateDeferredRecords function (p2p.h)

Article
02/22/2024

The PeerGraphValidateDeferredRecords function indicates to the Peer Graphing Infrastructure that it is time to resubmit any deferred records for the security module to validate.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphValidateDeferredRecords(
  [in] HGRAPH     hGraph,
  [in] ULONG      cRecordIds,
  [in] const GUID *pRecordIds
);

Parameters

[in] hGraph

Handle to the peer graph.

[in] cRecordIds

Specifies the number of records specified in pRecordIds. Specify zero (0) to instruct the Graphing infrastructure to validate all deferred records. If zero (0) is specified, pRecordIds is ignored.

[in] pRecordIds

Pointer to an array of record IDs to validate.

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_INVALIDARG	One of the parameters is not valid.
E_OUTOFMEMORY	There is not enough memory to perform the specified operation.
PEER_E_INVALID_GRAPH	The handle to the peer graph is invalid.
PEER_E_NOT_INITIALIZED	The peer graph must be initialized with a call to PeerGraphStartup before using this function.

Remarks

When a new record comes to the computer from its neighbor in the peer graph, the Peer Graphing Infrastructure attempts to validate the record by calling the PFNPEER_VALIDATE_RECORD callback, specified in the PEER_SECURITY_INTERFACE structure during a call to either PeerGraphCreate or PeerGraphOpen. If the security module does not have all the information necessary to validate the record, it returns the PEER_E_DEFERRED_VALIDATION error. Once the security module obtains enough information, it must then validate the records using PeerGraphValidateDeferredRecords. When this function is called, the Peer Graphing Infrastructure calls PFNPEER_VALIDATE_RECORD to validate the records with IDs in pRecordIds.

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

Share via