Compartir a través de

Función PeerGroupIssueCredentials (p2p.h)

  • Artículo

La función PeerGroupIssueCredentials emite credenciales, incluida una GMC, a una identidad específica y, opcionalmente, devuelve una cadena XML de invitación que el elemento del mismo nivel invitado puede usar para unirse a un grupo del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupIssueCredentials(
  [in]  HGROUP               hGroup,
  [in]  PCWSTR               pwzSubjectIdentity,
  [in]  PEER_CREDENTIAL_INFO *pCredentialInfo,
  [in]  DWORD                dwFlags,
  [out] PWSTR                *ppwzInvitation
);

Parámetros

[in] hGroup

Identificador de un grupo del mismo nivel para el que un elemento del mismo nivel emitirá credenciales a posibles elementos del mismo nivel invitados. La función PeerGroupCreate, PeerGroupOpen o PeerGroupJoin devuelve este identificador. Este parámetro es obligatorio.

[in] pwzSubjectIdentity

Especifica la identidad de un elemento del mismo nivel al que se emitirán las credenciales. Este parámetro es obligatorio.

[in] pCredentialInfo

PEER_CREDENTIAL_INFO estructura que contiene información sobre las credenciales de un elemento del mismo nivel cuya identidad se especifica en pwzSubjectIdentity. Si este parámetro es NULL, se usa la información almacenada en la base de datos del mismo nivel, en su lugar. Este parámetro es opcional.

Si se proporciona este parámetro, se omiten los siguientes campos de PEER_CREDENTIAL_INFO :

  • pwzIssuerPeerName
  • pwzIssuerFriendlyName

[in] dwFlags

Especifica un conjunto de marcas que se usan para describir las acciones realizadas cuando se emiten las credenciales. Si este parámetro se establece en 0 (cero), las credenciales se devuelven en ppwzInvitation. Este parámetro es opcional.

Value Significado
PEER_GROUP_STORE_CREDENTIALS
 Publique el GMC recién creado de la identidad del firmante en la base de datos de grupo. El asunto recoge automáticamente el GMC. Si no se establece esta marca, una aplicación diferente debe obtener las credenciales, como el correo electrónico.

[out] ppwzInvitation

Puntero a una cadena XML de invitación devuelta por la llamada de función. Esta invitación se pasa fuera de banda al elemento del mismo nivel invitado que lo usa en una llamada a PeerGroupJoin. Este parámetro es opcional.

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_INVALIDARG
 Uno de los parámetros no es válido.
E_OUTOFMEMORY
 No hay suficiente memoria disponible para completar la operación.
PEER_E_IDENTITY_DELETED
 Se ha eliminado la identidad que crea las credenciales.
PEER_E_IDENTITY_NOT_FOUND
 No se encuentra la identidad en la base de datos de grupo y pCredentialInfo es NULL.
PEER_E_NO_KEY_ACCESS
 Se deniega el acceso a las claves de identidad o grupo. 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 ha restablecido 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

Un administrador solo puede llamar a esta función correctamente.

Las credenciales de un miembro (PEER_CREDENTIAL_INFO) se obtienen mediante una llamada a PeerGroupEnumMembers. Las credenciales se encuentran en el campo pCredentialInfo de la estructura PEER_MEMBER para un miembro específico.

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