Compartir a través de

Función PeerGroupDelete (p2p.h)

  • Artículo

La función PeerGroupDelete elimina los datos locales y el certificado asociados a un grupo del mismo nivel.

Sintaxis

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

Parámetros

[in] pwzIdentity

Puntero a una cadena Unicode que contiene la identidad que abre el grupo del mismo nivel especificado. Si este parámetro es NULL, la implementación usa la identidad obtenida de PeerIdentityGetDefault.

[in] pwzGroupPeerName

Puntero a una cadena Unicode que contiene el nombre del mismo nivel del grupo del mismo nivel para el que se eliminan los datos. Este parámetro es obligatorio. El nombre del grupo se puede obtener llamando a PeerGroupGetProperties antes de PeerGroupClose o mediante el análisis de la invitación con PeerGroupParseInvitation.

Valor devuelto

Devuelve S_OK si la operación se realiza correctamente. De lo contrario, la función devuelve uno de los valores siguientes.

Nota Si se produce un error en una operación de eliminación debido a un error del sistema de archivos, se devuelve el error del sistema de archivos adecuado.
 
Código devuelto Descripción
E_ACCESSDENIED
 Se deniega el acceso a la base de datos del grupo del mismo nivel. Asegúrese de que el elemento del mismo nivel tiene permiso para realizar esta operación. En este caso, el elemento del mismo nivel debe ser el creador original del grupo del mismo nivel.
E_INVALIDARG
 Uno de los parámetros no es válido.
PEER_E_NOT_FOUND
 No se encuentra el grupo del mismo nivel.
PEER_E_NO_KEY_ACCESS
 Se deniega el acceso a las claves de identidad o grupo del mismo nivel. Normalmente, esto se debe a una lista de control de acceso (ACL) incorrecta para la carpeta que contiene las claves de usuario o equipo. Esto puede ocurrir cuando la ACL se restablece manualmente.
 

Los errores específicos de criptografía se pueden devolver desde el proveedor base RSA de Microsoft. Estos errores tienen el prefijo CRYPT_* y se definen en Winerror.h.

Comentarios

Si se elimina un grupo del mismo nivel, todos los identificadores asociados a ese grupo se convierten inmediatamente en no válidos. Como procedimiento recomendado, asegúrese de que todos los identificadores de este grupo estén cerrados antes de llamar a esta función. De lo contrario, estos datos se eliminan de todas las demás aplicaciones del mismo nivel en ejecución que la usan, lo que puede provocar errores e inestabilidad.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado p2p.h
Library P2P.lib
Archivo DLL P2P.dll

Consulte también

PeerGroupCreate