nf-p2p-peergroupdelete.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:p2p.PeerGroupDelete	PeerGroupDelete function (p2p.h)	The PeerGroupDelete function deletes the local data and certificate associated with a peer group.	PeerGroupDelete PeerGroupDelete function [Peer Networking] p2p.peergroupdelete p2p/PeerGroupDelete	p2p\peergroupdelete.htm	p2p	e98df845-71d9-41f9-bf05-b46014e861df	12/05/2018	PeerGroupDelete, PeerGroupDelete function [Peer Networking], p2p.peergroupdelete, p2p/PeerGroupDelete	p2p.h		Windows	Windows XP with SP2 [desktop apps only],Windows XP with SP1 with the Advanced Networking Pack forWindows XP	None supported										P2P.lib	P2P.dll		Windows			19H1	PeerGroupDelete p2p/PeerGroupDelete	c++	APIRef kbSyntax	DllExport	P2P.dll	PeerGroupDelete

PeerGroupDelete function

-description

The PeerGroupDelete function deletes the local data and certificate associated with a peer group.

-parameters

-param pwzIdentity [in]

Pointer to a Unicode string that contains the identity opening the specified peer group. If this parameter is NULL, the implementation uses the identity obtained from PeerIdentityGetDefault.

-param pwzGroupPeerName [in]

Pointer to a Unicode string that contains the peer name of the peer group for which data is deleted. This parameter is required. The group name can be obtained by calling PeerGroupGetProperties prior to PeerGroupClose, or by parsing the invitation with PeerGroupParseInvitation.

-returns

Returns S_OK if the operation succeeds. Otherwise, the function returns one of the following values.

Note  If a delete operation fails due to a file system error, the appropriate file system error is returned.

 

Return code	Description
E_ACCESSDENIED	Access to the peer group database is denied. Ensure that the peer has permission to perform this operation. In this case, the peer must be the original creator of the peer group.
E_INVALIDARG	One of the parameters is invalid.
PEER_E_NOT_FOUND	The peer group cannot be found.
PEER_E_NO_KEY_ACCESS	Access to the identity or peer group keys is denied. Typically, this is caused by an incorrect access control list (ACL) for the folder that contains the user or computer keys. This can happen when the ACL is reset manually.

 

Cryptography-specific errors can be returned from the Microsoft RSA Base Provider. These errors are prefixed with CRYPT_* and defined in Winerror.h.

-remarks

If a peer group is deleted, all handles associated with that group immediately become invalid. As a best practice, ensure that all handles for this group are closed before calling this function. Otherwise, this data is deleted from all other running peer applications that use it, which can cause errors and instability.

-see-also

PeerGroupCreate