PeerGroupIssueCredentials, fonction (p2p.h)

Article
03/04/2024

La fonction PeerGroupIssueCredentials émet des informations d’identification, y compris une console GMC, à une identité spécifique et retourne éventuellement une chaîne XML d’invitation que l’homologue invité peut utiliser pour rejoindre un groupe d’homologues.

Syntaxe

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

Paramètres

[in] hGroup

Gérez un groupe d’homologues pour lequel un homologue émettra des informations d’identification à des homologues invités potentiels. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] pwzSubjectIdentity

Spécifie l’identité d’un homologue auquel les informations d’identification seront émises. Ce paramètre est obligatoire.

[in] pCredentialInfo

PEER_CREDENTIAL_INFO structure qui contient des informations sur les informations d’identification d’un homologue dont l’identité est spécifiée dans pwzSubjectIdentity. Si ce paramètre a la valeur NULL, les informations stockées dans la base de données homologue sont utilisées à la place. Ce paramètre est facultatif.

Si ce paramètre est fourni, les champs suivants dans PEER_CREDENTIAL_INFO sont ignorés :

pwzIssuerPeerName
pwzIssuerFriendlyName

[in] dwFlags

Spécifie un ensemble d’indicateurs utilisés pour décrire les actions effectuées lors de l’émission d’informations d’identification. Si ce paramètre est défini sur 0 (zéro), les informations d’identification sont retournées dans ppwzInvitation. Ce paramètre est facultatif.

Valeur	Signification
PEER_GROUP_STORE_CREDENTIALS	Publiez la console GMC de l’identité du sujet nouvellement créée dans la base de données de groupe. Le GMC est automatiquement récupéré par l’objet. Si cet indicateur n’est pas défini, les informations d’identification doivent être obtenues par une autre application telle que l’e-mail.

[out] ppwzInvitation

Pointeur vers une chaîne XML d’invitation retournée par l’appel de fonction. Cette invitation est transmise hors bande à l’homologue invité qui l’utilise dans un appel à PeerGroupJoin. Ce paramètre est facultatif.

Valeur renvoyée

Retourne S_OK si l’opération réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire disponible est insuffisante pour terminer l’opération.
PEER_E_IDENTITY_DELETED	L’identité qui crée les informations d’identification a été supprimée.
PEER_E_IDENTITY_NOT_FOUND	L’identité est introuvable dans la base de données de groupe et pCredentialInfo a la valeur NULL.
PEER_E_NO_KEY_ACCESS	L’accès aux clés d’identité ou de groupe est refusé. En règle générale, cela est dû à une liste de contrôle d’accès (ACL) incorrecte pour le dossier qui contient les clés d’utilisateur ou d’ordinateur. Cela peut se produire lorsque l’ACL a été réinitialisée manuellement.

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de base Microsoft RSA. Ces erreurs sont préfixées par CRYPT_* et définies dans Winerror.h.

Remarques

Cette fonction ne peut être appelée que par un administrateur.

Les informations d’identification d’un membre (PEER_CREDENTIAL_INFO) sont obtenues en appelant PeerGroupEnumMembers. Les informations d’identification se trouvent dans le champ pCredentialInfo de la structure PEER_MEMBER pour un membre spécifique.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le pack de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2P.lib
DLL	P2P.dll

Partager via