Função PeerGroupDelete (p2p.h)

A função PeerGroupDelete exclui os dados locais e o certificado associados a um grupo de pares.

Sintaxe

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

Parâmetros

[in] pwzIdentity

Ponteiro para uma cadeia de caracteres Unicode que contém a identidade abrindo o grupo de pares especificado. Se esse parâmetro for NULL, a implementação usará a identidade obtida de PeerIdentityGetDefault.

[in] pwzGroupPeerName

Ponteiro para uma cadeia de caracteres Unicode que contém o nome do par do grupo de pares para o qual os dados são excluídos. Este parâmetro é necessário. O nome do grupo pode ser obtido chamando PeerGroupGetProperties antes de PeerGroupClose ou analisando o convite com PeerGroupParseInvitation.

Retornar valor

Retorna S_OK se a operação for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.

Nota Se uma operação de exclusão falhar devido a um erro do sistema de arquivos, o erro do sistema de arquivos apropriado será retornado.

 

Código de retorno	Descrição
E_ACCESSDENIED	O acesso ao banco de dados do grupo de pares foi negado. Verifique se o par tem permissão para executar essa operação. Nesse caso, o par deve ser o criador original do grupo de pares.
E_INVALIDARG	Um dos parâmetros é inválido.
PEER_E_NOT_FOUND	O grupo de pares não pode ser encontrado.
PEER_E_NO_KEY_ACCESS	O acesso às chaves de identidade ou de grupo par é negado. Normalmente, isso é causado por uma ACL (lista de controle de acesso) incorreta para a pasta que contém as chaves do usuário ou do computador. Isso pode acontecer quando a ACL é redefinida manualmente.

 

Erros específicos de criptografia podem ser retornados do Provedor Base do Microsoft RSA. Esses erros são prefixados com CRYPT_* e definidos em Winerror.h.

Comentários

Se um grupo de pares for excluído, todos os identificadores associados a esse grupo se tornarão imediatamente inválidos. Como prática recomendada, verifique se todos os identificadores desse grupo estão fechados antes de chamar essa função. Caso contrário, esses dados serão excluídos de todos os outros aplicativos pares em execução que os usam, o que pode causar erros e instabilidade.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	p2p.h
Biblioteca	P2P.lib
DLL	P2P.dll

Confira também

PeerGroupCreate