Sections Winsock dans un fichier INF réseau

Un fichier INF pour un composant NetTrans qui fournit une interface Winsock doit spécifier cette dépendance Winsock. Un tel fichier INF doit contenir une section Winsock-install . Pour créer une section WinsockInstall, ajoutez l'extension .Winsock au nom de la section DDInstall pour le protocole. Par exemple, si la section DDInstall d’un protocole est nommée Ipx, la section Winsock-install pour ce protocole doit être nommée Ipx.Winsock.

Remarque

La dépendance Winsock a été déconseillée dans Windows 8 et versions ultérieures.

Une section Winsock-install doit contenir une directive AddSock . La directive AddSock spécifie une section nommée fournisseur qui contient des valeurs à ajouter à la clé TransportDriverName\Params\WinsockHKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ du composant.

La section définie par le fournisseur spécifiée par la directive AddSock doit contenir les valeurs requises suivantes :

Nom de la valeur Descriptif

TransportService

Valeur REG_SZ qui spécifie le nom du service du protocole. Cela doit être identique à la valeur Ndi\Service pour le protocole. Pour plus d’informations, consultez Ajout de valeurs Service-Related à la clé Ndi.

HelperDllName

Valeur REG_EXPAND_SZ qui spécifie le chemin d’accès à la DLL de l’assistance Windows Sockets (WSH) pour le protocole. Pour plus d’informations, consultez WSH DLL Function Summary.

MaxSockAddrLength

Valeur REG_DWORD qui spécifie la plus grande taille SOCKADDR valide, en octets, pour la DLL WSH

MinSockAddrLength

Valeur REG_DWORD qui spécifie la plus petite taille SOCKADDR valide, en octets, pour la DLL WSH

Si un ProviderId facultatif pour un fournisseur d’espaces de noms est spécifié, les valeurs suivantes doivent également être spécifiées :

Nom de la valeur Descriptif

ProviderId

Valeur REG_SZ qui spécifie l’identificateur global unique (GUID) qui identifie le fournisseur d’espaces de noms. Le GUID est utilisé comme clé pour toutes les références suivantes au fournisseur d’espaces de noms. Obtenez le GUID en exécutant l’utilitaire uuidgen.exe. Pour plus d’informations sur cet utilitaire, consultez le Kit de développement logiciel (SDK) Microsoft Windows.

LibraryPath

Valeur REG_EXPAND_SZ qui spécifie le chemin d’accès complet à la DLL du fournisseur d’espaces de noms.

DisplayString

Chaîne localisable spécifiant le nom qui s'affiche pour le fournisseur de namespace dans l'interface utilisateur.

SupportedNameSpace

Valeur REG_DWORD qui spécifie l’espace de noms pris en charge par le fournisseur d’espaces de noms.

Version

Valeur REG_DWORD facultative qui spécifie le numéro de version du fournisseur d’espaces de noms. Si cette valeur n’est pas spécifiée, la valeur par défaut (1) est utilisée pour le numéro de version.

Les valeurs d’espace de noms suivantes peuvent être affectées à SupportedNameSpace et sont définies dans Winsock2.h :

Namespace Valeur

NS_ALL

0

NS_SAP

1

NS_NDS

2

NS_PEER_BROWSE

3

NS_TCPIP_LOCAL

10

NS_TCPIP_HOSTS

11

NS_DNS

12

NS_NETBT

13

NS_WINS

14

NS_NBP

20

NS_MS

30

NS_STDA

31

NS_CAIRO

32

NS_X500

40

NS_NIS

41

NS_WRQ

50

Pour plus d’informations sur les fournisseurs d’espaces de noms, consultez la documentation du Kit de développement logiciel (SDK) Windows.

L’exemple suivant montre les sections Winsock pour un protocole IPX :

[Ipx.Winsock]
AddSock = Install.IpxWinsock
 
[Install.IpxWinsock]
TransportService = nwlinkipx
HelperDllName = "%%SystemRoot%%\System32\wshisn.dll"
MaxSockAddrLength = 0x10
MinSockAddrLength = 0xe
ProviderId = "GUID"
LibraryPath = "%SystemRoot%\\System32\\nwprovau.dll"
DisplayString = %NwlnkIpx_Desc%
SupportedNameSpace = 1
Version = 2

Un fichier INF peut supprimer une dépendance Winsock pour un protocole en incluant une section Winsock-remove . Pour créer une section Winsock-remove, ajoutez l'extension .Winsock au nom de la section Supprimer pour le protocole. Par exemple, si la section Remove d’un protocole porte le nom Ipx.Remove, la section Winsock-remove du protocole doit être nommée Ipx.Remove.Winsock.

La section Winsock-remove contient une directive DelSock qui spécifie une section nommée INF-writer. La section INF-writer nommée doit spécifier le service de transport à supprimer. Si un ProviderId a été précédemment inscrit pour le protocole, la section nommée par le fournisseur doit également spécifier le ProviderId à supprimer.

L’exemple suivant montre deux sections qui suppriment la dépendance Winsock pour un protocole IPX :

[Ipx.Remove.Winsock]
DelSock = Remove.IpxWinsock
 
[Remove.IpxWinsock]
TransportService = nwlinkipx
ProviderId = "GUID"
  • Last updated on