Elevated plugin for Take Command / TCC / TCC/LE
Version 1.0.1.2 2024-10-03
Charles Dye
Purpose:
This plugin implements one function, @ELEVATED
,
to test whether a process is running elevated.
Windows Vista or later is required; this plugin will not load under earlier versions of Windows.
Installation:
To use this plugin, copy Elevated.dll to some
known location on your hard drive. (If you are still using the 32-bit version of
Take Command, take Elevated-x86.dll instead of
Elevated.dll.) Load the .DLL file with a
PLUGIN /L
command, for example:
plugin /l c:\bin\tcmd\test\elevated.dll
If you copy these files to a subdirectory named PlugIns within your Take Command program directory, the plugin will be loaded automatically when TCC starts.
Plugin Features:
Syntax Note:
The syntax definitions in the following text use these conventions for clarity:
BOLD CODE | indicates text which must be typed exactly as shown. |
CODE | indicates optional text, which may be typed as shown or omitted. |
Bold italic | names a required argument; a value must be supplied. |
Regular italic | names an optional argument. |
ellipsis… | after an argument means that more than one may be given. |
New Function:
@ELEVATED
— Tests whether
a process is elevated.
Syntax:
%@ELEVATED[
pid]
pid | the process ID of the process to check |
The pid may be entered in decimal, or hexadecimal with
a leading 0x
. If pid is not specified,
the current instance of TCC is assumed. @ELEVATED
returns one of:
1 | if the specified process is elevated |
0 | if the specified process is not elevated |
-1 | on any error |
echo %@elevated[0x25A0]
Startup Message:
This plugin displays an informational line when it initializes. The
message will be suppressed in transient or pipe shells. You can disable it
for all shells by defining an environment variable named NOLOADMSG
,
for example:
set /e /u noloadmsg=1
Status and Licensing:
This plugin is © Copyright 2024, Charles Dye. Unaltered copies of the binary and documentation files may be freely distributed without restriction. I make no guarantee and give no warranty for its operation. If you find a problem, you can report it in the JP Software support forum.
Download:
You can download the current version of the plugin from https://charlesdye.net/dl/elevated.zip.