PFNPEER_FREE_SECURITY_DATA callback function (p2p.h)

Article
02/22/2024

The PFNPEER_FREE_SECURITY_DATA callback specifies the function that the Peer Graphing Infrastructure calls to free data returned by PFNPEER_SECURE_RECORD and PFNPEER_VALIDATE_RECORD callbacks.

Syntax

PFNPEER_FREE_SECURITY_DATA PfnpeerFreeSecurityData;

HRESULT PfnpeerFreeSecurityData(
  [in] HGRAPH hGraph,
  [in] PVOID pvContext,
  [in] PPEER_DATA pSecurityData
)
{...}

Parameters

[in] hGraph

Specifies the peer graph associated with the specified record.

[in] pvContext

Pointer to the security context to free. This parameter is set to the value of the pvContext member of the PEER_SECURITY_INTERFACE structure passed in PeerGraphCreate or PeerGraphOpen.

[in] pSecurityData

Pointer to the security data to free.

Return value

If the callback is successful, the return value is S_OK. Otherwise, the callback 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.

Remarks

This callback can be invoked from any of the Peer Graphing API functions involving records, such as PeerGraphUpdateRecord.

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