2.3.7 Flags

  • Article

Several of the following structures have a Flags field. The specific Flags bits are defined as follows.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Flags (16 bytes)

...

...


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

0

0

0

0

0

0

0

A N

0

0

0

0

0

0

0

0

0

0

R L

S R

R
I

R C

H

R D

K B

S B

K
I

S
I

0

D

D D

I

Value

Description

I

TASK_FLAG_INTERACTIVE

If set to 1, specifies that the task can interact with the logged-on user.

DD

TASK_FLAG_DELETE_WHEN_DONE

If set to 1, specifies that the task can be deleted when there are no more scheduled run times.

D

TASK_FLAG_DISABLED

If set to 1, specifies that the task is disabled.

SI

TASK_FLAG_START_ONLY_IF_IDLE

If set to 1, specifies that the task begins only if the computer is not in use at the scheduled time.

KI

TASK_FLAG_KILL_ON_IDLE_END

If set to 1, specifies that the task can be terminated if the computer makes an idle to non-idle transition while the task is running. The computer makes an idle to non-idle transition when user input is detected.

SB

TASK_FLAG_DONT_START_IF_ON_BATTERIES

If set to 1, specifies that the task cannot start if its target computer is running on battery power.

KB

TASK_FLAG_KILL_IF_GOING_ON_BATTERIES

If set to 1, specifies that the task can end, and the associated application quit if the task's target computer switches to battery power.

RD

TASK_FLAG_RUN_ONLY_IF_DOCKED

Unused. MUST be set to zero when sent and MUST be ignored on receipt.

H

TASK_FLAG_HIDDEN

If set to 1, specifies that the task is hidden.

RC

TASK_FLAG_RUN_IF_CONNECTED_TO_INTERNET

Unused. MUST be set to zero when sent and MUST be ignored on receipt.

RI

TASK_FLAG_RESTART_ON_IDLE_RESUME

If set to 1, specifies that the task can start again if the computer makes a non-idle to idle transition before all the task's triggers elapse.

SR

TASK_FLAG_SYSTEM_REQUIRED

If set to 1, specifies that the task can cause the system to resume, or awaken if the system is sleeping.

RL

TASK_FLAG_RUN_ONLY_IF_LOGGED_ON

If set to 1, specifies that the task can only run if the user specified in the task is logged on interactively.

AN

TASK_APPLICATION_NAME

If set to 1, specifies that the task has an application name defined.

Flags (16 bytes): Undefined bits. MUST be set to zero when sent and MUST be ignored on receipt.