Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction PeerPnrpRegister inscrit un homologue auprès d’un cloud PNRP et retourne un handle qui peut être utilisé pour les mises à jour d’inscription.
Note Lorsqu’elle est appelée, cette fonction se bloque jusqu’à ce que le service PNRP ait été lancé.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpRegister(
[in] PCWSTR pcwzPeerName,
[in, optional] PPEER_PNRP_REGISTRATION_INFO pRegistrationInfo,
[out] HREGISTRATION *phRegistration
);
Paramètres
[in] pcwzPeerName
Pointeur vers une chaîne Unicode sans fin qui contient le nom d’homologue à inscrire auprès du service PNRP.
[in, optional] pRegistrationInfo
Pointeur vers une structure PEER_PNRP_REGISTRATION_INFO qui contient les informations de point de terminaison pour le nœud homologue d’inscription. Si la valeur est NULL, l’API inscrit l’homologue avec tous les clouds PNRP connus, et toutes les adresses inscrites sont automatiquement sélectionnées par l’infrastructure.
[out] phRegistration
Gérez l’inscription PNRP pour le nœud homologue appelant. Utilisez ce handle pour mettre à jour l’inscription ou annuler l’inscription auprès du service PNRP.
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. |
|
L’homologue local utilise une identité qui n’existe pas. |
En outre, cette fonction peut retourner des valeurs WSA. Pour obtenir la liste complète des valeurs possibles, consultez Codes d’erreur PNRP NSP.
Remarques
Un handle doit être inscrit dans un processus distinct du processus dans lequel il sera résolu. Si un handle est inscrit et résolu dans le même processus, il ne sera pas reconnu.
Un nom ne peut pas être inscrit avec un point de terminaison plusieurs fois. Lorsque des mises à jour d’un nom inscrit sont requises, utilisez PeerPnrpUpdateRegistration.
Lorsque pRegistrationInfo a la valeur NULL ou qu’PEER_PNRP_AUTO_ADDRESSES est spécifié pour cAddresses, l’infrastructure maintient les adresses inscrites à jour à mesure que les adresses changent ou que la disponibilité du cloud change.
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 | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | p2p.h |
| Bibliothèque | P2P.lib |
| DLL | P2P.dll |