• Article

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 Subobject_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.