SnapshotJobID Property

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 SnapshotJobID property returns a system-generated value uniquely identifying the SQL Server Agent job that implements initial snapshot-generation of third-party published article data.

Syntax

object.SnapshotJobID

Parts

  • object
    An expression that evaluates to an object in the Applies To list

Data Type

String

Modifiable

Read-only

Prototype (C/C++)

HRESULT GetSnapshotJobID(SQLDMO_LPBSTR pRetVal);

Note

SQL Distributed Management Objects (SQL-DMO) strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.

Remarks

The property returns an empty string if no snapshot job is associated with the third-party publication. To associate a snapshot job with a third-party publication, a user must create a SQL Server Agent job that implements initial snapshot-generation of third-party published article data and then associate the snapshot job with a third-party publication by setting snapshot job name using the SnapshotAgentproperty of the DistributionPublication2 object.

Note

If an application calls SnapshotJobID on an instance of SQL Server version 7.0 with the DistributionPublication2 object, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000 or later" are returned.