Share via


PingSQLServerVersion Method

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 PingSQLServerVersion method returns a long integer that describes an instance of Microsoft SQL Server.

Syntax

object
.PingSQLServerVersion( [ ServerName ] , [ Login ] ,  [ Password ] )as SQLDMO_SQL_VER

Parts

  • object
    Expression that evaluates to an object in the Applies To list.
  • ServerName
    Optional. A string that identifies an instance of SQL Server by installed name.
  • Login
    Optional. A string that identifies an existing SQL Server login by name.
  • Password
    Optional. A string that supplies a password and is used for authentication of the Login argument in method execution.

Prototype (C/C++)

HRESULT PingSQLServerVersion(SQLDMO_SQL_VER *pRetVal,
SQLDMO_LPCSTR szServerName, SQLDMO_LPCSTR szLogin,
SQLDMO_LPCSTR szPassword);

Returns

Evaluate the return value of the PingSQLServerVersion method by using these SQLDMO_SQL_VER values.

Constant Value Description

SQLDMOSQLVer_60

2

SQL Server version 6.0

SQLDMOSQLVer_65

4

SQL Server version 6.5

SQLDMOSQLVer_70

8

SQL Server version 7.0

SQLDMOSQLVer_80

16

SQL Server 2000

SQLDMOSQLVer_90

32

SQL Server 2005

SQLDMOSQLVer_Pre_60

1

SQL Server version 6.0 or earlier

SQLDMOSQLVer_Unknown

0

Bad or invalid value

Remarks

The SQL Distributed Management Objects (SQL-DMO) object library released with later versions of SQL Server cannot connect to or be used to administer an instance of SQL Server with a version earlier than 7.0. To administer instances of SQL Server 7.0 and earlier, an application can reference the SQL-DMO object library released with SQL Server 2000 or later, and the library released with an earlier version.

The PingSQLServerVersion method:

  • Connects to an instance of SQL Server.
  • Queries the instance for version information.
  • Disconnects from the instance indicated.

The method cannot be used on a connected SQLServer object.

When the ServerName argument is not specified, the PingSQLServerVersion method attempts to connect to an instance of SQL Server using the network name of the computer on which the application is running.

When used, the Login and Password arguments indicate use of SQL Server Authentication for connection validation. When no value is supplied in the Login argument, Windows Authentication is used for connection validation and any value aupplied in the Password argument is ignored.

Applies To:

SQLServer Object