PeerCreatePeerName, fonction (p2p.h)
La fonction PeerCreatePeerName crée un nom basé sur le nom existant de l’identité d’homologue et du classifieur spécifiés. Toutefois, une nouvelle identité n’est pas créée par un appel à PeerCreatePeerName.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzClassifier,
[out] PWSTR *ppwzPeerName
);
Paramètres
[in] pwzIdentity
Spécifie l’identité à utiliser comme base pour le nouveau nom d’homologue. Si pwzIdentity a la valeur NULL, le nom créé n’est basé sur aucune identité d’homologue et est donc un nom non sécurisé.
Ce paramètre ne peut être NULL que si pwzClassifier n’est pas NULL.
[in] pwzClassifier
Pointeur vers la chaîne Unicode qui contient le nouveau classifieur. Ce classifieur est ajouté à la partie autorité existante du nom d’homologue de l’identité spécifiée. Cette chaîne contient 150 caractères, y compris la marque de fin NULL . Spécifiez NULL pour renvoyer le nom d’homologue de l’identité.
Ce paramètre ne peut être NULL que si pwzIdentity n’a pas la valeur NULL.
[out] ppwzPeerName
Pointeur qui reçoit un pointeur vers le nouveau nom d’homologue. Lorsque cette chaîne n’est plus nécessaire, libérez-la en appelant PeerFreeData.
Valeur retournée
Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, elle retourne l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
L’un des paramètres n’est pas valide. |
|
La mémoire est insuffisante pour effectuer l’opération spécifiée. |
Remarques
Le paramètre ppwzPeername doit avoir la valeur Null avant que la fonction PeerCreatePeerName soit appelée.
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 |