From aed206e1bebb640ffee786b7e5b2b36b143901a6 Mon Sep 17 00:00:00 2001
From: antiduh <antiduh@e114e3f1-24f7-e311-a78f-001bfcf5e160>
Date: Tue, 1 Jul 2014 02:10:53 +0000
Subject: [PATCH] Working on writing comments and documentation.

---
 NSspi/SecPkgInfo.cs     | 92 +++++++++++++++++++++++++++++++++++++++++
 NSspi/SecurityStatus.cs | 25 ++++++++++-
 2 files changed, 116 insertions(+), 1 deletion(-)

diff --git a/NSspi/SecPkgInfo.cs b/NSspi/SecPkgInfo.cs
index 9b85a42..c5502f4 100644
--- a/NSspi/SecPkgInfo.cs
+++ b/NSspi/SecPkgInfo.cs
@@ -7,69 +7,161 @@ using System.Threading.Tasks;
 
 namespace NSspi
 {
+    /// <summary>
+    /// Stores information about a particular security package.
+    /// </summary>
     [StructLayout( LayoutKind.Sequential )]
     public class SecPkgInfo
     {
+        /// <summary>
+        /// The packages capabilities and options.
+        /// </summary>
         public SecPkgCapability Capabilities;
 
+        /// <summary>
+        /// The package's version number.
+        /// </summary>
         public short Version;
 
+        /// <summary>
+        /// The package's Id when used in RPC contexts.
+        /// </summary>
         public short RpcId;
 
+        /// <summary>
+        /// The maximum size, in bytes, of tokens generated by the package.
+        /// </summary>
         public int MaxTokenLength;
 
+        /// <summary>
+        /// The human-readable name of the package.
+        /// </summary>
         [MarshalAs( UnmanagedType.LPWStr )]
         public string Name;
 
+        /// <summary>
+        /// A short description of the package.
+        /// </summary>
         [MarshalAs( UnmanagedType.LPWStr )]
         public string Comment;
     }
 
+    /// <summary>
+    /// Describes the capabilities of a security package. 
+    /// </summary>
     [Flags]
     public enum SecPkgCapability : uint 
     {
+        /// <summary>
+        /// Whether the package supports generating messages with integrity information. Required for MakeSignature and VerifySignature.
+        /// </summary>
         Integrity       = 0x1,
 
+        /// <summary>
+        /// Whether the package supports generating encrypted messages. Required for EncryptMessage and DecryptMessage.
+        /// </summary>
         Privacy         = 0x2,
 
+        /// <summary>
+        /// Whether the package uses any other buffer information than token buffers.
+        /// </summary>
         TokenOnly       = 0x4,
 
+        /// <summary>
+        /// Whether the package supports datagram-style authentication.
+        /// </summary>
         Datagram        = 0x8,
 
+        /// <summary>
+        /// Whether the package supports creating contexts with connection semantics
+        /// </summary>
         Connection      = 0x10,
 
+        /// <summary>
+        /// Multiple legs are neccessary for authentication.
+        /// </summary>
         MultiLeg        = 0x20,
 
+        /// <summary>
+        /// Server authentication is not supported.
+        /// </summary>
         ClientOnly      = 0x40,
 
+        /// <summary>
+        /// Supports extended error handling facilities.
+        /// </summary>
         ExtendedError   = 0x80,
 
+        /// <summary>
+        /// Supports client impersonation on the server.
+        /// </summary>
         Impersonation   = 0x100,
 
+        /// <summary>
+        /// Understands Windows princple and target names.
+        /// </summary>
         AcceptWin32Name = 0x200,
 
+        /// <summary>
+        /// Supports stream semantics
+        /// </summary>
         Stream          = 0x400,
 
+        /// <summary>
+        /// Package may be used by the Negiotiate meta-package.
+        /// </summary>
         Negotiable      = 0x800,
 
+        /// <summary>
+        /// Compatible with GSS.
+        /// </summary>
         GssCompatible   = 0x1000,
 
+        /// <summary>
+        /// Supports LsaLogonUser
+        /// </summary>
         Logon           = 0x2000,
 
+        /// <summary>
+        /// Token buffers are in Ascii format.
+        /// </summary>
         AsciiBuffers    = 0x4000,
 
+        /// <summary>
+        /// Supports separating large tokens into multiple buffers.
+        /// </summary>
         Fragment        = 0x8000,
 
+        /// <summary>
+        /// Supports mutual authentication between a client and server.
+        /// </summary>
         MutualAuth      = 0x10000,
 
+        /// <summary>
+        /// Supports credential delegation from the server to a third context.
+        /// </summary>
         Delegation      = 0x20000,
 
+        /// <summary>
+        /// Supports calling EncryptMessage with the read-only-checksum flag, which protects data only 
+        /// with a checksum and does not encrypt it.
+        /// </summary>
         ReadOnlyChecksum = 0x40000,
 
+        /// <summary>
+        /// Whether the package supports handling restricted tokens, which are tokens derived from existing tokens
+        /// that have had restrictions placed on them.
+        /// </summary>
         RestrictedTokens = 0x80000,
 
+        /// <summary>
+        /// Extends the negotiate package; only one such package may be registered at any time.
+        /// </summary>
         ExtendsNego     = 0x00100000,
 
+        /// <summary>
+        /// This package is negotiated by the package of type ExtendsNego.
+        /// </summary>
         Negotiable2     = 0x00200000,
     }
 }
diff --git a/NSspi/SecurityStatus.cs b/NSspi/SecurityStatus.cs
index ea3caa7..bb86ed7 100644
--- a/NSspi/SecurityStatus.cs
+++ b/NSspi/SecurityStatus.cs
@@ -22,11 +22,34 @@ namespace NSspi
 
     public enum SecurityStatus : uint
     {
-        // Success / Informational
+        // --- Success / Informational ---
+
+        /// <summary>
+        /// The request completed successfully
+        /// </summary>
         OK                  = 0x00000000,
+        
+        /// <summary>
+        /// The token returned by the context needs to be provided to the cooperating party
+        /// to continue construction of the context.
+        /// </summary>
         ContinueNeeded      = 0x00090312,
+
+        /// <summary>
+        /// Occurs after a client calls InitializeSecurityContext to indicate that the client
+        /// must call CompleteAuthToken.
+        /// </summary>
         CompleteNeeded      = 0x00090313,
+
+        /// <summary>
+        /// Occurs after a client calls InitializeSecurityContext to indicate that the client
+        /// must call CompleteAuthToken and pass the result to the server.
+        /// </summary>
         CompAndContinue     = 0x00090314,
+
+        /// <summary>
+        /// An attempt to use the context was performed after the context's expiration time elapsed.
+        /// </summary>
         ContextExpired      = 0x00090317,
         CredentialsNeeded   = 0x00090320,
         Renegotiate         = 0x00090321,