ImpersonateClient Property

SQL-DMO

SQL-DMO

ImpersonateClient Property

The ImpersonateClient property exposes the security context for nonadministrative users executing xp_cmdshell.

Applies To
IntegratedSecurity Object
Syntax

object.ImpersonateClient [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetImpersonateClient(LPBOOL pRetVal);

HRESULT SetImpersonateClient(BOOL NewValue);

Remarks

xp_cmdshell, a Microsoft® SQL Server™ system stored procedure, executes an operating system command, returning any results of command execution as text.

If TRUE, xp_cmdshell runs in the security context of the client connection.

If FALSE, xp_cmdshell runs in the security context of SQL Server Agent. The default is FALSE.