ReAssignJobsByLogin Method (SQL-DMO)

The ReAssignJobsByLogin method changes ownership for any SQL Server Agent jobs currently owned by a Microsoft® SQL Server™ login.

Applies To

JobServer Object

Syntax

object.ReAssignJobsByLogin( OldLogin , NewLogin )

Part Description
object Expression that evaluates to an object in the Applies To list.
OldLogin String specifying a login currently owning jobs.
NewLogin String specifying a login with job creation rights. The login specified will receive ownership.

Remarks

By default, any SQL Server login has membership, through the user guest, in the public role of the system database maintaining SQL Server Agent jobs (msdb). When a SQL Server user is created in msdb, jobs created by the user mapping the login are owned by the login, not the user.

Reassigning SQL Server Agent job ownership by using the ReAssignJobsByLogin method requires appropriate privilege. The SQL Server login used for SQLServer object connection must be a member of the fixed role sysadmin.

Prototype (C/C++)

HRESULT ReAssignJobsByLogin(
SQLDMO_LPCSTR szOldLogin,
SQLDMO_LPCSTR szNewLogin);

  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.