Winsock-Abschnitte in einer Netzwerk-INF-Datei
Eine INF-Datei für eine NetTrans-Komponente , die eine Winsock-Schnittstelle bereitstellt, muss diese Winsock-Abhängigkeit angeben. Eine solche INF-Datei muss einen Winsock-install-Abschnitt enthalten. Um einen Winsockinstall-Abschnitt zu erstellen, fügen Sie hinzu. Winsock-Erweiterung für den DDInstall-Abschnittsnamen für das Protokoll. Wenn beispielsweise der Abschnitt DDInstall für ein Protokoll den Namen Ipx hat, muss der Winsock-install-Abschnitt für dieses Protokoll ipx.Winsock heißen.
Hinweis
Die Winsock-Abhängigkeit ist in Windows 8 und höher veraltet.
Ein Winsock-install-Abschnitt muss eine AddSock-Direktive enthalten. Die AddSock-Direktive gibt einen Abschnitt mit dem Namen eines Anbieters an, der Werte enthält, die dem HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Schlüssel TransportDriverName\Params\Winsock der Komponente hinzugefügt werden sollen.
Der von der AddSock-Direktive referenzierte Abschnitt mit Anbieternamen muss die folgenden erforderlichen Werte enthalten:
| Wertname | BESCHREIBUNG |
|---|---|
TransportService |
Ein REG_SZ Wert, der den Dienstnamen des Protokolls angibt. Dies muss mit dem Wert Ndi\Service für das Protokoll identisch sein. Weitere Informationen finden Sie unter Hinzufügen Service-Related Werte zum Ndi-Schlüssel. |
HelperDllName |
Ein REG_EXPAND_SZ Wert, der den Pfad zur Windows Sockets-Hilfs-DLL (WSH) für das Protokoll angibt. Weitere Informationen finden Sie unter Zusammenfassung der WSH-DLL-Funktion. |
MaxSockAddrLength |
Ein REG_DWORD Wert, der die größte gültige SOCKADDR-Größe in Byte für die WSH-DLL angibt. |
MinSockAddrLength |
Ein REG_DWORD Wert, der die kleinste gültige SOCKADDR-Größe in Bytes für die WSH-DLL angibt. |
Wenn eine optionale ProviderId für einen Namespaceanbieter angegeben wird, müssen auch die folgenden Werte angegeben werden:
| Wertname | BESCHREIBUNG |
|---|---|
ProviderId |
Ein REG_SZ Wert, der die GUID (Globally Unique Identifier) angibt, die den Namespaceanbieter identifiziert. Die GUID wird als Schlüssel für alle nachfolgenden Verweise auf den Namespaceanbieter verwendet. Rufen Sie die GUID ab, indem Sie das Hilfsprogramm uuidgen.exe ausführen. Weitere Informationen zu diesem Hilfsprogramm finden Sie im Microsoft Windows SDK. |
LibraryPath |
Ein REG_EXPAND_SZ Wert, der den vollständigen Pfad zur Namespaceanbieter-DLL angibt. |
DisplayString |
Eine lokalisierbare Zeichenfolge, die den Namen angibt, der für den Namespaceanbieter auf der Benutzeroberfläche angezeigt wird. |
SupportedNameSpace |
Ein REG_DWORD Wert, der den vom Namespaceanbieter unterstützten Namespace angibt. |
Version |
Ein optionaler REG_DWORD Wert, der die Versionsnummer des Namespaceanbieters angibt. Wenn dieser Wert nicht angegeben wird, wird der Standardwert (1) für die Versionsnummer verwendet. |
Die folgenden Namespacewerte können SupportedNameSpace zugewiesen werden und sind in Winsock2.h definiert:
| Namespace | Wert |
|---|---|
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 |
Weitere Informationen zu Namespaceanbietern finden Sie in der Windows SDK-Dokumentation.
Das folgende Beispiel zeigt Winsock-Abschnitte für ein IPX-Protokoll:
[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
Eine INF-Datei kann eine Winsock-Abhängigkeit für ein Protokoll entfernen, indem sie einen Winsock-Remove-Abschnitt einschließt. Um einen Winsock-remove-Abschnitt zu erstellen, fügen Sie hinzu. Winsock-Erweiterung für den Abschnittsnamen entfernen für das Protokoll. Wenn beispielsweise der Abschnitt Remove für ein Protokoll den Namen Ipx.Remove hat, muss der Winsock-remove-Abschnitt für das Protokoll den Namen Ipx.Remove.Winsock haben.
Der Abschnitt Winsock-remove enthält eine DelSock-Direktive , die einen Abschnitt mit dem Namen INF-writer angibt. Im Abschnitt "INF-writer-named" muss der zu entfernende Transportdienst angegeben werden. Wenn zuvor eine ProviderId für das Protokoll registriert wurde, muss im Abschnitt mit dem Namen des Anbieters auch die zu entfernende ProviderId angegeben werden.
Das folgende Beispiel zeigt zwei Abschnitte, in denen die Winsock-Abhängigkeit für ein IPX-Protokoll entfernt wird:
[Ipx.Remove.Winsock]
DelSock = Remove.IpxWinsock
[Remove.IpxWinsock]
TransportService = nwlinkipx
ProviderId = "GUID"