Seções Winsock num arquivo INF de rede

Um arquivo INF para um componente NetTrans que fornece uma interface Winsock deve especificar essa dependência Winsock. Esse arquivo INF deve conter uma seção Winsock-install. Para criar uma seção Winsockinstall, adicione a extensão .Winsock ao nome da seção DDInstall para o protocolo. Por exemplo, se a secção DDInstall de um protocolo se chamar Ipx, a secção Winsock-install para esse protocolo deve ser chamada Ipx.Winsock.

Observação

A dependência do Winsock foi preterida no Windows 8 e posterior.

Uma seção Winsock-install deve conter uma diretiva AddSock. A diretiva AddSock especifica uma seção nomeada pelo fornecedor que contém valores a serem adicionados à chave de HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\TransportDriverName\Params\Winsock do componente.

A seção nomeada pelo fornecedor referenciada pela diretiva AddSock deve conter os seguintes valores necessários:

Nome do valor Descrição

Serviço de Transporte

Um valor REG_SZ que especifica o nome do serviço do protocolo. Isso deve ser o mesmo que o valor Ndi\Service para o protocolo. Para obter mais informações, consulte Adicionando valores de Service-Related à chave Ndi.

HelperDllName

Um valor REG_EXPAND_SZ que especifica o caminho para a DLL auxiliar do Windows Sockets (WSH) para o protocolo. Para obter mais informações, consulte Resumo da função DLL WSH.

MaxSockAddrLength

Um valor REG_DWORD que especifica o maior tamanho SOCKADDR válido, em bytes, para a DLL WSH

MinSockAddrLength

Um valor REG_DWORD que especifica o menor tamanho SOCKADDR válido, em bytes, para a DLL WSH

Se um opcional ProviderId para um provedor de namespace for especificado, os seguintes valores também deverão ser especificados:

Nome do valor Descrição

ProviderId

Um valor REG_SZ que especifica o GUID (Identificador Globalmente Exclusivo) que identifica o provedor de namespace. O GUID é usado como uma chave para todas as referências subsequentes ao provedor de namespace. Obtenha o GUID executando o utilitário uuidgen.exe. Para obter mais informações sobre esse utilitário, consulte o SDK do Microsoft Windows.

Caminho da Biblioteca

Um valor REG_EXPAND_SZ que especifica o caminho completo para a DLL do provedor de namespace.

DisplayString

Uma cadeia de caracteres localizável que especifica o nome exibido para o provedor de namespace na interface do usuário.

SupportedNameSpace

Um valor REG_DWORD que especifica o namespace suportado pelo provedor de namespace.

Versão

Um valor REG_DWORD opcional que especifica o número da versão do provedor de namespace. Se esse valor não for especificado, o valor padrão (1) será usado para o número da versão.

Os seguintes valores de namespace podem ser atribuídos a SupportedNameSpace e são definidos em Winsock2.h:

Espaço de nomes Valor

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

Para obter mais informações sobre provedores de namespace, consulte a documentação do SDK do Windows.

O exemplo a seguir mostra seções Winsock para um protocolo 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

Um arquivo INF pode remover uma dependência do Winsock para um protocolo incluindo uma seção Winsock-remove. Para criar uma seção Winsock-remove, adicione o arquivo . Extensão Winsock para o Remover nome da seção para o protocolo. Por exemplo, se a seção Remover de um protocolo for chamada Ipx.Remove, a seção Winsock-remove do protocolo deverá ser denominada Ipx.Remove.Winsock.

A seção Winsock-remove contém uma diretiva DelSock que especifica uma seção identificada pelo nome dado pelo escritor INF. A seção INF-writer-named deve especificar o serviço de transporte a ser removido. Se um ProviderId foi registado anteriormente para o protocolo, a seção denominada pelo fornecedor também deve especificar o ProviderId a remover.

O exemplo a seguir mostra duas seções que removem a dependência Winsock para um protocolo IPX:

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