ReAssignJobsByLogin Method

SQL-DMO

SQL-DMO

ReAssignJobsByLogin Method

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

Applies To
JobServer Object
Syntax

object.ReAssignJobsByLogin( OldLogin , NewLogin )

Parts

object

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

OldLogin

String that specifies a login currently owning jobs.

NewLogin

String that specifies a login with job creation rights. The login specified will receive ownership.

Prototype (C/C++)

HRESULT ReAssignJobsByLogin(
SQLDMO_LPCSTR szOldLogin,
SQLDMO_LPCSTR szNewLogin);

Remarks

By default, any SQL Server login has membership, through the user guest, in the public role of the system database maintaining SQLServerAgent 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 SQLServerAgent job ownership by using the ReAssignJobsByLogin method requires appropriate permission. The SQL Server login used for SQLServer object connection must be a member of the fixed role sysadmin.