Freigeben über


PingSQLServerVersion Method

Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird.

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

Hinweise

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 applied in the Password argument is ignored.

Applies To: