Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.
The SuperSocketList property returns a super socket protocol list.
Syntax
object
.SuperSocketList [= value]
Parts
- object
An expression that evaluates to an object in the Applies To list
- value
A SQL Distributed Management Objects (SQL-DMO) multistring that lists super socket protocols
Data Type
String
Modifiable
Read/write
Prototype (C/C++)
HRESULT GetSuperSocketList(SQLDMO_LPBSTR pRetVal);
HRESULT SetSuperSocketList(SQLDMO_LPCSTR NewValue);
Remarks
The protocol list specifies the Net-Libraries (for example, TCP/IP, IPX/SPX, or named pipes) on which Microsoft SQL Server can listen. To set the SuperSocketList property, you must be a member of the sysadmin fixed server role.
- np
Named Pipes
- tcp
TCP/IP
- rpc
Multiprotocol
- spx
IPX/SPX
- adsp
AppleTalk
- bv
Banyan Vines
- via
VIA system area networks (Giganet and QLogic
Each time you set the SuperSocketList property the Net-Libraries listed are enabled and all other Net-Libraries are disabled except for the shared memory Net-Library, which is always enabled and cannot be configured.
Note
MSDE applications may need to disable all the server Net-Libraries (except shared memory) by setting SuperSocketList to an empty string.
The example shows how to configure an instance with shared memory, named pipes, and TCP/IP Net-Libraries enabled:
Dim r as NEW SQLDMO.Registry2
Set r = oSQLServer.Registry
r.SuperSocketList = "[np] [tcp]"
The example shows how to disable all the Net-Libraries (except shared memory) for an instance:
Dim r as NEW SQLDMO.Registry2
Set r = oSQLServer.Registry
r.SuperSocketList = ""
For more information about setting multistring parameters, see Using SQL-DMO Multistrings.
Note
If an application calls SuperSocketList on an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000 or later" are returned.