From 33ac1031d95f538b543f66baf61e9474bca584bb Mon Sep 17 00:00:00 2001
From: Simon Rozman <simon@rozman.si>
Date: Tue, 28 Jul 2020 09:31:32 +0200
Subject: [PATCH] Add documentation and samples

Signed-off-by: Simon Rozman <simon@rozman.si>
---
 README.md                         |  23 +++++++++++++++++++++++
 samples/LockIfOutOfLogonHours.xml | Bin 0 -> 24564 bytes
 2 files changed, 23 insertions(+)
 create mode 100644 README.md
 create mode 100644 samples/LockIfOutOfLogonHours.xml

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..38dca34
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# LockIfOutOfLogonHours - Lock Windows User Desktop When Logon Hours Denied
+
+LockIfOutOfLogonHours is a small utility to test if the invoking user is within permitted logon hours or not.
+
+If not, the utility locks the user desktop, locking the user out but not killing users' work.
+
+If logon hours are to expire within 10 minutes, a prompt is displayed encouraging the user to finish her/his work in time.
+
+## Running
+
+Use Task Scheduler to schedule the `LockIfOutOfLogonHours.exe` to run periodically as the interactive user.
+
+Active Directory allows configuring logon hours rounded to the whole hours only. Therefore, it makes sense to trigger the `LockIfOutOfLogonHours.exe` to run:
+
+- Sometime before the hour is out (up to 10 minutes before the hour is out, e.g. 0:55, 1:55, ..., 23:55). This trigger notifies the user.
+
+- At or just after the hour is out (e.g. 0:01, 1:01, ..., 23:01). This trigger locks the user out.
+
+A sample task XML to be imported in Task Scheduler can be found in [`samples\LockIfOutOfLogonHours.xml`](samples/LockIfOutOfLogonHours.xml).
+
+## Building
+
+Microsoft Visual Studio 2019 is required.
diff --git a/samples/LockIfOutOfLogonHours.xml b/samples/LockIfOutOfLogonHours.xml
new file mode 100644
index 0000000000000000000000000000000000000000..674ba29d819f33d140f9f0e5b1c2b76b9ed8d1b0
GIT binary patch
literal 24564
zcmeHP+iu%N5S`}&{RhGCwk6e;t%6mM#Az)ciGx^%U;3h2@&&diL!{%jAK&DhT~Xwc
zy3j@+G{8WR$Z%)pc7~)m+??<KMe;`emWez_L%zvaW|GLAOeL1zWJg-ECrxY{7>VTy
z$43~A<;IO($UuIVT}X8x^G15|v-~6xjt-&aex=5?)99_nkffzsN%47<Uu7Sk1h#Hr
zbK*4ZVS9%oGuTh?y@uqT^JW6sXXnuf$Dc8}FKu|-lmqNFvA^%;rr4%)uXg5sHsD_*
zUt#428WN1pAdzC9(f9Ga#-5LfvR?kJJVE9bBQuPhLwe%m8_+bBf1SrM^zKV2$;{+h
zPGFTW&M^ORVY4S6q2mgfOCbA%U*gd~&MAElxhbR@h?BXAvG;%@H~4a&K0QI6bBEZD
zvE|GdHpbYaPpj;P-d!M;KBD_`;ZGmAICGJoVUJ#VtEUT_)Sk`DwDDN|{IYJCj~je^
z9hP(d9&tUmh(<2LP(GCQXq_Wx%tb2ioToAJz<>XP=vXH$IYRw%>wgE>Z=wcyguhLf
zwRKvuSaWPYAmc;%%XvD29oE$oyk<7aW7XN`z@O-jFo&_egRdvhM~}<WK1M&9xQb0N
zV}|pXdFmksk2z;A8!zjlbY1(DeF+}Xi=<zVp2yA5TVFlfieB5!y&C8Kwxaiop{E$V
z14B<SdWVLdV)QzOo?`Tl3_Zo@9UFRz(d!y|YSC+1uccP6XFH$wTJs*6^;$IcT3YCT
zTAy=spLJW$J?pj9>5^|Nde&>vjGpycG^1y|7R~5cuSGL@)@#v>p7mPvqQ})P_PnR{
zd9Q7~7R8;iw)I+6qi4Mqz4tx8p7T)rGrO(lT(zEbJ3D259j>9bX*KY+qQ`d(hMrdR
zc;7Shw4%p%42GUo^!WFRp{Er+zGE=-w4%p%42GUo^!Sd!(9?<@-!T|^I??m%ISoCn
z=y4^dp{Er+>$T|ZQn$o<Et=7@UW;b*tk<F$J?ph-M$dXJn$fdfi)Qq!*P<6azn;^c
z)^$Fu`}LfLo>ug%*P{8#X}y;J8$GT+3)wi60$*h$U%*O9-q<V0cS?53;<#sftjaVX
zJ#y@@MK0AMe{0UVc>#^&zU*TLd0ELyyNho2F4kUikN@AjgWp4J52P!{_;9R?PY2%v
zjCIk4>*DB<lRU<;CgeHF`TTSoqh@HU%A%R`qYl8l`3S#y1$NFMvOtzuvh5DQN_vm2
zXN+Aoud4kkm_cK3u#TMu@_cfijJxSP&)=Y(+@a)AB{J0+MXi*m=00Z|T|QpKFG9Y@
zu+FH+4O|@a*nV<srW}8Co{?Rb{tmId!rTNNOff>1UoxHcp(Vx<ve<sc_u0kqQY~SW
zC(xcaW>m7~KEvmX8`iVi#^72d|F7pzC1)<<xOOvGTg=1jbcBA;E_r-u^$+a%oSh-w
z&Guh5H?;c}`Sp>XBBmM6lL4ZdIeug^)-vvLy!GaUcJjPlx>f%%n2^ax%bLu1aYI(z
zdNV>RzNVSA2UHAm$vR1aE34*ysm&0}*JucR;I)S5+4}1DXTS;0fFi$i4;4Sa)#cN?
zuF9iDOJ2jJ%VCOH<eVNOPBKw@JuNwPdREC)wPlsW3}$hVotRh8Fi-0wt9r@zoWL*7
zx?I#=*1Jx!sF&wm=HdEGM?gKR@w}$!19`8>CB7`adUHaL$~?|>Ii4fnbcY;!UhZ;6
z!m-d|wOX^Bl(npr40W<vc=zF5$j>V4S|$<d_yG3!F|OLIMbDg`)#pc7r+14QZQ?v3
zmi1<YR{Z^mXEycm4sqmkRgY)$XlZq|uu}Y8c#4`JWBPmKAcpQS;z>9D%@Hl4$nTT+
w-y+mCDbyS9>tuD`%%Z;M?E8C7SxXj~zZ&Fu%spVtVO)NU#|OZg9P&N+0a;ZX^Z)<=

literal 0
HcmV?d00001