Funzione PeerGroupDelete (p2p.h)

Articolo
03/05/2024

La funzione PeerGroupDelete elimina i dati e il certificato locali associati a un gruppo peer.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDelete(
  [in] PCWSTR pwzIdentity,
  [in] PCWSTR pwzGroupPeerName
);

Parametri

[in] pwzIdentity

Puntatore a una stringa Unicode contenente l'identità che apre il gruppo di peer specificato. Se questo parametro è NULL, l'implementazione usa l'identità ottenuta da PeerIdentityGetDefault.

[in] pwzGroupPeerName

Puntatore a una stringa Unicode contenente il nome peer del gruppo peer per cui i dati vengono eliminati. Questo parametro è obbligatorio. Il nome del gruppo può essere ottenuto chiamando PeerGroupGetProperties prima di PeerGroupClose o analizzando l'invito con PeerGroupParseInvitation.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Nota Se un'operazione di eliminazione non riesce a causa di un errore di file system, viene restituito l'errore appropriato del file system.

Codice restituito	Descrizione
E_ACCESSDENIED	L'accesso al database del gruppo peer viene negato. Assicurarsi che il peer disponga dell'autorizzazione per eseguire questa operazione. In questo caso, il peer deve essere il creatore originale del gruppo di peer.
E_INVALIDARG	Uno dei parametri non è valido.
PEER_E_NOT_FOUND	Impossibile trovare il gruppo peer.
PEER_E_NO_KEY_ACCESS	L'accesso alle chiavi di gruppo di identità o peer viene negato. In genere, questo è causato da un elenco di controllo di accesso non corretto (ACL) per la cartella che contiene le chiavi utente o computer. Ciò può verificarsi quando l'ACL viene reimpostato manualmente.

Gli errori specifici della crittografia possono essere restituiti dal provider di base Microsoft RSA. Questi errori sono preceduti da CRYPT_* e definiti in Winerror.h.

Commenti

Se un gruppo peer viene eliminato, tutti gli handle associati a tale gruppo diventano immediatamente non validi. Come procedura consigliata, assicurarsi che tutti gli handle per questo gruppo vengano chiusi prima di chiamare questa funzione. In caso contrario, questi dati vengono eliminati da tutte le altre applicazioni peer in esecuzione che lo usano, che possono causare errori e instabilità.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll

Vedi anche

PeerGroupCreate

Condividi tramite