NextMedia Event

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 NextMedia event occurs when a backup or restore operation exhausts the media in a device indicated as a target or source for the operation.

Syntax

Private Sub
object
_NextMedia(
Message as String
)

Parts

• object
  Expression that evaluates to an object in the Applies To list.

• Message
  String that contains descriptive message text.

Prototype (C/C++)

HRESULT NextMedia(SQLDMO_LPCSTR Message);

Remarks

With SQL Distributed Management Objects (SQL-DMO), use the SQLBackup, SQLRestore, and SQLVerify methods to start a backup or restore operation.

Applies To:

Backup Object

Restore Object