Compartir a través de

Función PeerGroupSetProperties (p2p.h)

  • Artículo

La función PeerGroupSetProperties establece las propiedades del grupo del mismo nivel actuales. En la versión 1.0 de esta API, solo el creador del grupo del mismo nivel puede realizar esta operación.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSetProperties(
  [in] HGROUP                 hGroup,
  [in] PPEER_GROUP_PROPERTIES pProperties
);

Parámetros

[in] hGroup

Controle al grupo del mismo nivel cuyas propiedades se establecen mediante un elemento del mismo nivel. La función PeerGroupCreate, PeerGroupOpen o PeerGroupJoin devuelve este identificador. Este parámetro es obligatorio.

[in] pProperties

Puntero a una estructura de PEER_GROUP_PROPERTIES rellenada por el mismo nivel que contiene las nuevas propiedades. Para obtener esta estructura, un elemento del mismo nivel debe llamar primero a PeerGroupGetProperties, cambiar los campos adecuados y, a continuación, pasarlo como este parámetro. Este parámetro es obligatorio.

No se pueden cambiar los siguientes miembros de PEER_GROUP_PROPERTIES :

  • dwSize
  • pwzCloud
  • pwzClassifier
  • pwzGroupPeerName
  • pwzCreatorPeerName

Valor devuelto

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

Código devuelto Descripción
E_OUTOFMEMORY
 No hay suficiente memoria disponible para completar la operación.
PEER_E_GROUP_NOT_READY
 El grupo no está en un estado en el que se pueden establecer las propiedades del grupo del mismo nivel. Por ejemplo, se ha llamado a PeerGroupJoin , pero no se ha completado la sincronización con la base de datos del grupo del mismo nivel.
PEER_E_INVALID_GROUP
 El identificador del grupo del mismo nivel no es válido.
PEER_E_INVALID_GROUP_PROPERTIES
 Una o varias de las propiedades especificadas no son válidas.
PEER_E_NOT_AUTHORIZED
 La identidad actual no tiene la autorización para cambiar estas propiedades. En este caso, la identidad no es el creador del grupo del mismo nivel.
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY
 La contraseña especificada no cumple los requisitos de contraseña del sistema.
 

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

En el caso de las aplicaciones que usan contraseñas, se recomienda que las contraseñas se controlan de forma segura mediante una llamada a las funciones CryptoProtectMemory y SecureZeroMemory .

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

PEER_GROUP_PROPERTIES

PeerGroupCreate

PeerGroupGetProperties

PeerGroupJoin

PeerGroupOpen