PeerIdentityCreate, fonction (p2p.h)

Article
03/04/2024

La fonction PeerIdentityCreate crée une identité d’homologue et retourne son nom. Le nom de l’identité d’homologue doit être transmis dans tous les appels suivants aux fonctions Peer Identity Manager, Peer Grouping ou PNRP qui fonctionnent pour le compte de l’identité d’homologue. Le nom d’identité d’homologue spécifie l’identité d’homologue utilisée.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityCreate(
  [in]  PCWSTR     pwzClassifier,
  [in]  PCWSTR     pwzFriendlyName,
  [in]  HCRYPTPROV hCryptProv,
  [out] PWSTR      *ppwzIdentity
);

Paramètres

[in] pwzClassifier

Spécifie le classifieur à ajouter au nom d’identité d’homologue publié. Cette chaîne est une chaîne Unicode et peut avoir la valeur NULL. Cette chaîne ne peut avoir que 150 caractères, y compris la terminaison NULL .

[in] pwzFriendlyName

Spécifie le nom convivial de l’identité d’homologue. Il s’agit d’une chaîne Unicode qui peut avoir la valeur NULL. Cette chaîne ne peut avoir que 256 caractères, y compris la terminaison NULL . Si pwzFriendlyName a la valeur NULL, le nom de l’identité est le nom convivial. Le nom convivial est facultatif et il n’a pas besoin d’être unique.

[in] hCryptProv

Gérez le fournisseur de services de chiffrement (CSP) qui contient une paire de clés AT_KEYEXCHANGE d’au moins 1 024 bits. Cette paire de clés est utilisée comme base pour une nouvelle identité d’homologue. Si hCryptProv est égal à zéro (0), une nouvelle paire de clés est générée pour l’identité d’homologue.

Note L’API Identity Manager ne prend pas en charge un fournisseur de solutions cloud qui possède des clés protégées par l’utilisateur. Si un fournisseur de solutions cloud disposant de clés protégées par l’utilisateur est utilisé, PeerIdentityCreate retourne E_INVALIDARG.

[out] ppwzIdentity

Reçoit un pointeur vers le nom d’une identité d’homologue créée. Ce nom doit être utilisé dans tous les appels suivants aux fonctions Peer Identity Manager, Peer Grouping ou PNRP qui fonctionnent pour le compte de l’identité d’homologue. Retourne la valeur NULL si l’identité d’homologue ne peut pas être créée.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il retourne l’une des valeurs suivantes.

Code de retour	Description
ERROR_INVALID_HANDLE	Le handle de la clé spécifiée par hCryptProv n’est pas valide.
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération spécifiée.
PEER_E_ALREADY_EXISTS	L’identité d’homologue existe déjà. Se produit uniquement si une identité d’homologue basée sur la clé et le classifieur spécifiés existe déjà.
PEER_E_NO_KEY_ACCESS	L’accès à l’identité d’homologue ou aux clés de groupe d’homologues est refusé. En règle générale, cela est dû à une liste de contrôle d’accès incorrecte pour le dossier qui contient les clés utilisateur ou ordinateur. Cela peut se produire lorsque l’ACL a été réinitialisée manuellement.
PEER_E_TOO_MANY_IDENTITIES	L’identité d’homologue ne peut pas être créée, car il existe trop d’identités d’homologues.

Remarques

La paire de clés et le classifieur sont utilisés pour générer le nom d’homologue d’une nouvelle identité d’homologue. Une fois qu’une identité d’homologue est créée, elle est automatiquement stockée sur le disque.

Le nom de l’identité doit être libéré à l’aide de PeerFreeData. Cela ne supprime pas l’identité d’homologue. Pour supprimer l’identité, utilisez la fonction PeerIdentityDelete .

Si hCryptProv n’a pas la valeur NULL, il peut être libéré à l’aide de CryptReleaseContext après le retour de l’appel.

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

Voir aussi

CryptReleaseContext

PeerFreeData

PeerIdentityDelete

Partager via