home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / vc98 / include / secpkg.h < prev    next >
C/C++ Source or Header  |  1998-04-25  |  28KB  |  1,013 lines
  1. //+-----------------------------------------------------------------------
  2. //
  3. // Microsoft Windows
  4. //
  5. // Copyright (c) Microsoft Corporation 1991-1997
  6. //
  7. // File:        secpkg.h
  8. //
  9. // Contents:    Global definitions for security packages
  10. //              This file will contain everything specific to writing
  11. //              a security package.
  12. //
  13. //
  14. // History:     10 Mar 92   RichardW    Created
  15. //              24-Mar-94   wader   Changed EstablishCredentials to SystemLogon
  16. //
  17. //------------------------------------------------------------------------
  18.  
  19.  
  20. #ifndef __SECPKG_H__
  21. #define __SECPKG_H__
  22.  
  23. #include <ntlsa.h> // SECURITY_LOGON_TYPE
  24.  
  25. #ifdef SECURITY_KERNEL
  26. //
  27. // Can't use the windows.h def'ns in kernel mode.
  28. //
  29. typedef PVOID                   SEC_THREAD_START;
  30. typedef PVOID                   SEC_ATTRS;
  31. #else
  32. typedef LPTHREAD_START_ROUTINE  SEC_THREAD_START;
  33. typedef LPSECURITY_ATTRIBUTES   SEC_ATTRS;
  34. #endif
  35.  
  36.  
  37.  
  38.  
  39. //
  40. // The following structures are used by the helper functions
  41. //
  42.  
  43. typedef struct _SECPKG_CLIENT_INFO {
  44.     LUID            LogonId;            // Effective Logon Id
  45.     ULONG           ProcessID;          // Process Id of caller
  46.     ULONG           ThreadID;           // Thread Id of caller
  47.     BOOLEAN         HasTcbPrivilege;    // Client has TCB
  48.     BOOLEAN         Impersonating;      // Client is impersonating
  49. } SECPKG_CLIENT_INFO, * PSECPKG_CLIENT_INFO;
  50.  
  51. typedef struct _SECPKG_CALL_INFO {
  52.     ULONG           ProcessId ;
  53.     ULONG           ThreadId ;
  54.     ULONG           Attributes ;
  55.     ULONG           Reserved ;
  56. } SECPKG_CALL_INFO, * PSECPKG_CALL_INFO ;
  57.  
  58. #define SECPKG_CALL_KERNEL_MODE 0x00000001  // Call originated in kernel mode
  59. #define SECPKG_CALL_ANSI        0x00000002  // Call came from ANSI stub
  60. #define SECPKG_CALL_URGENT      0x00000004  // Call designated urgent
  61.  
  62.  
  63. typedef struct _SECPKG_SUPPLEMENTAL_CRED {
  64.     UNICODE_STRING PackageName;
  65.     ULONG CredentialSize;
  66.     PUCHAR Credentials;
  67. } SECPKG_SUPPLEMENTAL_CRED, *PSECPKG_SUPPLEMENTAL_CRED;
  68.  
  69.  
  70.  
  71. //
  72. // This flag is used for to indicate which buffers in the SPMgr are located
  73. // in the client's address space
  74. //
  75.  
  76. #define SECBUFFER_UNMAPPED 0x40000000
  77.  
  78. typedef NTSTATUS
  79. (NTAPI LSA_CALLBACK_FUNCTION)(
  80.     ULONG       Argument1,
  81.     ULONG       Argument2,
  82.     PSecBuffer  InputBuffer,
  83.     PSecBuffer  OutputBuffer
  84.     );
  85.  
  86. typedef LSA_CALLBACK_FUNCTION * PLSA_CALLBACK_FUNCTION ;
  87.  
  88.  
  89. //////////////////////////////////////////////////////////////////////////
  90. //
  91. // The following prototypes are to functions that are provided by the SPMgr
  92. // to security packages.
  93. //
  94. //////////////////////////////////////////////////////////////////////////
  95.  
  96. typedef NTSTATUS
  97. (NTAPI LSA_IMPERSONATE_CLIENT) (
  98.     VOID
  99.     );
  100.  
  101.  
  102. typedef NTSTATUS
  103. (NTAPI LSA_UNLOAD_PACKAGE)(
  104.     VOID
  105.     );
  106.  
  107. typedef NTSTATUS
  108. (NTAPI LSA_DUPLICATE_HANDLE)(
  109.     IN HANDLE SourceHandle,
  110.     OUT PHANDLE DestionationHandle);
  111.  
  112.  
  113. typedef NTSTATUS
  114. (NTAPI LSA_SAVE_SUPPLEMENTAL_CREDENTIALS)(
  115.     IN PLUID LogonId,
  116.     IN ULONG SupplementalCredSize,
  117.     IN PVOID SupplementalCreds,
  118.     IN BOOLEAN Synchronous
  119.     );
  120.  
  121.  
  122. typedef HANDLE
  123. (NTAPI LSA_CREATE_THREAD)(
  124.     IN SEC_ATTRS SecurityAttributes,
  125.     IN ULONG StackSize,
  126.     IN SEC_THREAD_START StartFunction,
  127.     IN PVOID ThreadParameter,
  128.     IN ULONG CreationFlags,
  129.     OUT PULONG ThreadId
  130.     );
  131.  
  132.  
  133. typedef NTSTATUS
  134. (NTAPI LSA_GET_CLIENT_INFO)(
  135.     OUT PSECPKG_CLIENT_INFO ClientInfo
  136.     );
  137.  
  138.  
  139. typedef HANDLE
  140. (NTAPI LSA_REGISTER_NOTIFICATION)(
  141.     IN SEC_THREAD_START StartFunction,
  142.     IN PVOID Parameter,
  143.     IN ULONG NotificationType,
  144.     IN ULONG NotificationClass,
  145.     IN ULONG NotificationFlags,
  146.     IN ULONG IntervalMinutes,
  147.     IN OPTIONAL HANDLE WaitEvent
  148.     );
  149.  
  150.  
  151. typedef NTSTATUS
  152. (NTAPI LSA_CANCEL_NOTIFICATION)(
  153.     IN HANDLE NotifyHandle
  154.     );
  155.  
  156. typedef NTSTATUS
  157. (NTAPI LSA_MAP_BUFFER)(
  158.     IN PSecBuffer InputBuffer,
  159.     OUT PSecBuffer OutputBuffer
  160.     );
  161.  
  162. typedef NTSTATUS
  163. (NTAPI LSA_CREATE_TOKEN) (
  164.     IN PLUID LogonId,
  165.     IN PTOKEN_SOURCE TokenSource,
  166.     IN SECURITY_LOGON_TYPE LogonType,
  167.     IN SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  168.     IN LSA_TOKEN_INFORMATION_TYPE TokenInformationType,
  169.     IN PVOID TokenInformation,
  170.     IN PTOKEN_GROUPS TokenGroups,
  171.     IN PUNICODE_STRING AccountName,
  172.     IN PUNICODE_STRING AuthorityName,
  173.     IN PUNICODE_STRING Workstation,
  174.     OUT PHANDLE Token,
  175.     OUT PNTSTATUS SubStatus
  176.     );
  177.  
  178. typedef VOID
  179. (NTAPI LSA_AUDIT_LOGON) (
  180.     IN NTSTATUS Status,
  181.     IN NTSTATUS SubStatus,
  182.     IN PUNICODE_STRING AccountName,
  183.     IN PUNICODE_STRING AuthenticatingAuthority,
  184.     IN PUNICODE_STRING WorkstationName,
  185.     IN OPTIONAL PSID UserSid,
  186.     IN SECURITY_LOGON_TYPE LogonType,
  187.     IN PTOKEN_SOURCE TokenSource,
  188.     IN PLUID LogonId
  189.     );
  190.  
  191. typedef NTSTATUS
  192. (NTAPI LSA_CALL_PACKAGE) (
  193.     IN PUNICODE_STRING AuthenticationPackage,
  194.     IN PVOID ProtocolSubmitBuffer,
  195.     IN ULONG SubmitBufferLength,
  196.     OUT PVOID *ProtocolReturnBuffer,
  197.     OUT PULONG ReturnBufferLength,
  198.     OUT PNTSTATUS ProtocolStatus
  199.     );
  200.  
  201. typedef NTSTATUS
  202. (NTAPI LSA_CALL_PACKAGEEX) (
  203.     IN PUNICODE_STRING AuthenticationPackage,
  204.     IN PVOID ClientBufferBase,
  205.     IN PVOID ProtocolSubmitBuffer,
  206.     IN ULONG SubmitBufferLength,
  207.     OUT PVOID *ProtocolReturnBuffer,
  208.     OUT PULONG ReturnBufferLength,
  209.     OUT PNTSTATUS ProtocolStatus
  210.     );
  211.  
  212. typedef VOID
  213. (NTAPI LSA_FREE_LSA_HEAP) (
  214.     IN PVOID Base
  215.     );
  216.  
  217. typedef BOOLEAN
  218. (NTAPI LSA_GET_CALL_INFO) (
  219.     OUT PSECPKG_CALL_INFO   Info
  220.     );
  221.  
  222. typedef PVOID
  223. (NTAPI LSA_CREATE_SHARED_MEMORY)(
  224.     ULONG MaxSize,
  225.     ULONG InitialSize
  226.     );
  227.  
  228. typedef PVOID
  229. (NTAPI LSA_ALLOCATE_SHARED_MEMORY)(
  230.     PVOID SharedMem,
  231.     ULONG Size
  232.     );
  233.  
  234. typedef VOID
  235. (NTAPI LSA_FREE_SHARED_MEMORY)(
  236.     PVOID SharedMem,
  237.     PVOID Memory
  238.     );
  239.  
  240. typedef BOOLEAN
  241. (NTAPI LSA_DELETE_SHARED_MEMORY)(
  242.     PVOID SharedMem
  243.     );
  244.  
  245. //
  246. // Account Access
  247. //
  248.  
  249. typedef enum _SECPKG_NAME_TYPE {
  250.     SecNameSamCompatible,
  251.     SecNameAlternateId,
  252.     SecNameFlat,
  253.     SecNameDN
  254. } SECPKG_NAME_TYPE ;
  255.  
  256. typedef NTSTATUS
  257. (NTAPI LSA_OPEN_SAM_USER)(
  258.     PSECURITY_STRING Name,
  259.     SECPKG_NAME_TYPE NameType,
  260.     PSECURITY_STRING Prefix,
  261.     BOOLEAN AllowGuest,
  262.     ULONG Reserved,
  263.     PVOID * UserHandle
  264.     );
  265.  
  266. typedef NTSTATUS
  267. (NTAPI LSA_GET_USER_CREDENTIALS)(
  268.     PVOID UserHandle,
  269.     PVOID * PrimaryCreds,
  270.     PULONG PrimaryCredsSize,
  271.     PVOID * SupplementalCreds,
  272.     PULONG SupplementalCredsSize
  273.     );
  274.  
  275. typedef NTSTATUS
  276. (NTAPI LSA_GET_USER_AUTH_DATA)(
  277.     PVOID UserHandle,
  278.     PUCHAR * UserAuthData,
  279.     PULONG UserAuthDataSize
  280.     );
  281.  
  282. typedef NTSTATUS
  283. (NTAPI LSA_CLOSE_SAM_USER)(
  284.     PVOID UserHandle
  285.     );
  286.  
  287. typedef NTSTATUS
  288. (NTAPI LSA_CONVERT_AUTH_DATA_TO_TOKEN_INFO)(
  289.     PVOID UserAuthData,
  290.     ULONG UserAuthDataSize,
  291.     PVOID * TokenInformation,
  292.     PLSA_TOKEN_INFORMATION_TYPE TokenInformationType,
  293.     PSECURITY_STRING UserName
  294.     );
  295.  
  296. typedef NTSTATUS
  297. (NTAPI LSA_FREE_TOKEN_INFO)(
  298.     LSA_TOKEN_INFORMATION_TYPE TokenInfoType,
  299.     PVOID TokenInformation
  300.     );
  301.  
  302. typedef NTSTATUS
  303. (NTAPI LSA_CLIENT_CALLBACK)(
  304.     PCHAR   Callback,
  305.     ULONG   Argument1,
  306.     ULONG   Argument2,
  307.     PSecBuffer Input,
  308.     PSecBuffer Output
  309.     );
  310.  
  311. typedef
  312. NTSTATUS
  313. (NTAPI LSA_REGISTER_CALLBACK)(
  314.     ULONG   CallbackId,
  315.     PLSA_CALLBACK_FUNCTION Callback
  316.     );
  317.  
  318. #define NOTIFIER_FLAG_NEW_THREAD    0x00000001
  319. #define NOTIFIER_FLAG_ONE_SHOT      0x00000002
  320. #define NOTIFIER_FLAG_HANDLE_FREE   0x00000004
  321. #define NOTIFIER_FLAG_SECONDS       0x80000000
  322.  
  323. #define NOTIFIER_TYPE_INTERVAL      1
  324. #define NOTIFIER_TYPE_HANDLE_WAIT   2
  325. #define NOTIFIER_TYPE_STATE_CHANGE  3
  326. #define NOTIFIER_TYPE_NOTIFY_EVENT  4
  327. #define NOTIFIER_TYPE_IMMEDIATE 16
  328.  
  329. #define NOTIFY_CLASS_PACKAGE_CHANGE 1
  330. #define NOTIFY_CLASS_ROLE_CHANGE    2
  331. #define NOTIFY_CLASS_DOMAIN_CHANGE  3
  332.  
  333. typedef struct _SECPKG_EVENT_PACKAGE_CHANGE {
  334.     ULONG   ChangeType;
  335.     ULONG   PackageId;
  336.     SECURITY_STRING PackageName;
  337. } SECPKG_EVENT_PACKAGE_CHANGE, * PSECPKG_EVENT_PACKAGE_CHANGE ;
  338.  
  339. #define SECPKG_PACKAGE_CHANGE_LOAD      0
  340. #define SECPKG_PACKAGE_CHANGE_UNLOAD    1
  341. #define SECPKG_PACKAGE_CHANGE_SELECT    2
  342.  
  343. typedef struct _SECPKG_EVENT_ROLE_CHANGE {
  344.     ULONG   PreviousRole ;
  345.     ULONG   NewRole ;
  346. } SECPKG_EVENT_ROLE_CHANGE, * PSECPKG_EVENT_ROLE_CHANGE ;
  347.  
  348. typedef struct _SECPKG_PARAMETERS SECPKG_EVENT_DOMAIN_CHANGE ;
  349. typedef struct _SECPKG_PARAMETERS * PSECPKG_EVENT_DOMAIN_CHANGE ;
  350.  
  351.  
  352. typedef struct _SECPKG_EVENT_NOTIFY {
  353.     ULONG EventClass;
  354.     ULONG Reserved;
  355.     ULONG EventDataSize;
  356.     PVOID EventData;
  357.     PVOID PackageParameter;
  358. } SECPKG_EVENT_NOTIFY, *PSECPKG_EVENT_NOTIFY ;
  359.  
  360. typedef LSA_IMPERSONATE_CLIENT * PLSA_IMPERSONATE_CLIENT;
  361. typedef LSA_UNLOAD_PACKAGE * PLSA_UNLOAD_PACKAGE;
  362. typedef LSA_DUPLICATE_HANDLE * PLSA_DUPLICATE_HANDLE ;
  363. typedef LSA_SAVE_SUPPLEMENTAL_CREDENTIALS * PLSA_SAVE_SUPPLEMENTAL_CREDENTIALS;
  364. typedef LSA_CREATE_THREAD * PLSA_CREATE_THREAD;
  365. typedef LSA_GET_CLIENT_INFO * PLSA_GET_CLIENT_INFO;
  366. typedef LSA_REGISTER_NOTIFICATION * PLSA_REGISTER_NOTIFICATION;
  367. typedef LSA_CANCEL_NOTIFICATION * PLSA_CANCEL_NOTIFICATION;
  368. typedef LSA_MAP_BUFFER * PLSA_MAP_BUFFER;
  369. typedef LSA_CREATE_TOKEN * PLSA_CREATE_TOKEN;
  370. typedef LSA_AUDIT_LOGON * PLSA_AUDIT_LOGON;
  371. typedef LSA_CALL_PACKAGE * PLSA_CALL_PACKAGE;
  372. typedef LSA_CALL_PACKAGEEX * PLSA_CALL_PACKAGEEX;
  373. typedef LSA_GET_CALL_INFO * PLSA_GET_CALL_INFO ;
  374. typedef LSA_CREATE_SHARED_MEMORY * PLSA_CREATE_SHARED_MEMORY ;
  375. typedef LSA_ALLOCATE_SHARED_MEMORY * PLSA_ALLOCATE_SHARED_MEMORY ;
  376. typedef LSA_FREE_SHARED_MEMORY * PLSA_FREE_SHARED_MEMORY ;
  377. typedef LSA_DELETE_SHARED_MEMORY * PLSA_DELETE_SHARED_MEMORY ;
  378. typedef LSA_OPEN_SAM_USER * PLSA_OPEN_SAM_USER ;
  379. typedef LSA_GET_USER_CREDENTIALS * PLSA_GET_USER_CREDENTIALS ;
  380. typedef LSA_GET_USER_AUTH_DATA * PLSA_GET_USER_AUTH_DATA ;
  381. typedef LSA_CLOSE_SAM_USER * PLSA_CLOSE_SAM_USER ;
  382. typedef LSA_CONVERT_AUTH_DATA_TO_TOKEN_INFO * PLSA_CONVERT_AUTH_DATA_TO_TOKEN_INFO ;
  383. typedef LSA_FREE_TOKEN_INFO * PLSA_FREE_TOKEN_INFO ;
  384. typedef LSA_CLIENT_CALLBACK * PLSA_CLIENT_CALLBACK ;
  385.  
  386. typedef LSA_REGISTER_CALLBACK * PLSA_REGISTER_CALLBACK ;
  387.  
  388. // Functions provided by the SPM to the packages:
  389. typedef struct _LSA_SECPKG_FUNCTION_TABLE {
  390.     PLSA_CREATE_LOGON_SESSION CreateLogonSession;
  391.     PLSA_DELETE_LOGON_SESSION DeleteLogonSession;
  392.     PLSA_ADD_CREDENTIAL AddCredential;
  393.     PLSA_GET_CREDENTIALS GetCredentials;
  394.     PLSA_DELETE_CREDENTIAL DeleteCredential;
  395.     PLSA_ALLOCATE_LSA_HEAP AllocateLsaHeap;
  396.     PLSA_FREE_LSA_HEAP FreeLsaHeap;
  397.     PLSA_ALLOCATE_CLIENT_BUFFER AllocateClientBuffer;
  398.     PLSA_FREE_CLIENT_BUFFER FreeClientBuffer;
  399.     PLSA_COPY_TO_CLIENT_BUFFER CopyToClientBuffer;
  400.     PLSA_COPY_FROM_CLIENT_BUFFER CopyFromClientBuffer;
  401.     PLSA_IMPERSONATE_CLIENT ImpersonateClient;
  402.     PLSA_UNLOAD_PACKAGE UnloadPackage;
  403.     PLSA_DUPLICATE_HANDLE DuplicateHandle;
  404.     PLSA_SAVE_SUPPLEMENTAL_CREDENTIALS SaveSupplementalCredentials;
  405.     PLSA_CREATE_THREAD CreateThread;
  406.     PLSA_GET_CLIENT_INFO GetClientInfo;
  407.     PLSA_REGISTER_NOTIFICATION RegisterNotification;
  408.     PLSA_CANCEL_NOTIFICATION CancelNotification;
  409.     PLSA_MAP_BUFFER MapBuffer;
  410.     PLSA_CREATE_TOKEN CreateToken;
  411.     PLSA_AUDIT_LOGON AuditLogon;
  412.     PLSA_CALL_PACKAGE CallPackage;
  413.     PLSA_FREE_LSA_HEAP FreeReturnBuffer;
  414.     PLSA_GET_CALL_INFO GetCallInfo;
  415.     PLSA_CALL_PACKAGEEX CallPackageEx;
  416.     PLSA_CREATE_SHARED_MEMORY CreateSharedMemory;
  417.     PLSA_ALLOCATE_SHARED_MEMORY AllocateSharedMemory;
  418.     PLSA_FREE_SHARED_MEMORY FreeSharedMemory;
  419.     PLSA_DELETE_SHARED_MEMORY DeleteSharedMemory;
  420.     PLSA_OPEN_SAM_USER OpenSamUser ;
  421.     PLSA_GET_USER_CREDENTIALS GetUserCredentials ;
  422.     PLSA_GET_USER_AUTH_DATA GetUserAuthData ;
  423.     PLSA_CLOSE_SAM_USER CloseSamUser ;
  424.     PLSA_CONVERT_AUTH_DATA_TO_TOKEN_INFO ConvertAuthDataToTokenInfo ;
  425.     PLSA_FREE_TOKEN_INFO FreeTokenInfo ;
  426.     PLSA_CLIENT_CALLBACK ClientCallback ;
  427. } LSA_SECPKG_FUNCTION_TABLE, *PLSA_SECPKG_FUNCTION_TABLE;
  428.  
  429. typedef struct _SECPKG_DLL_FUNCTIONS {
  430.     PLSA_ALLOCATE_LSA_HEAP AllocateHeap;
  431.     PLSA_FREE_LSA_HEAP FreeHeap;
  432.     PLSA_REGISTER_CALLBACK RegisterCallback ;
  433. } SECPKG_DLL_FUNCTIONS, * PSECPKG_DLL_FUNCTIONS;
  434.  
  435.  
  436.  
  437. #define PRIMARY_CRED_CLEAR_PASSWORD 0x1
  438. #define PRIMARY_CRED_OWF_PASSWORD 0x2
  439.  
  440. typedef struct _SECPKG_PRIMARY_CRED {
  441.     LUID LogonId;
  442.     UNICODE_STRING DownlevelName;
  443.     UNICODE_STRING DomainName;
  444.     UNICODE_STRING Password;
  445.     UNICODE_STRING OldPassword;
  446.     PSID UserSid;
  447.     ULONG Flags;
  448. } SECPKG_PRIMARY_CRED, *PSECPKG_PRIMARY_CRED;
  449.  
  450. //
  451. // Maximum size of stored credentials.
  452. //
  453.  
  454. #define MAX_CRED_SIZE 1024
  455.  
  456. #define SECPKG_STATE_ENCRYPTION_PERMITTED               0x01
  457. #define SECPKG_STATE_STRONG_ENCRYPTION_PERMITTED        0x02
  458.  
  459. typedef struct _SECPKG_PARAMETERS {
  460.     ULONG           Version;
  461.     ULONG           MachineState;
  462.     ULONG           SetupMode;
  463.     PSID            DomainSid;
  464.     UNICODE_STRING  DomainName;
  465.     UNICODE_STRING  DnsDomainName;
  466. } SECPKG_PARAMETERS, *PSECPKG_PARAMETERS;
  467.  
  468.  
  469. //
  470. // Extended Package information structures
  471. //
  472.  
  473. typedef enum _SECPKG_EXTENDED_INFORMATION_CLASS {
  474.     SecpkgGssInfo = 1,
  475.     SecpkgContextThunks,
  476.     SecpkgMaxInfo
  477. } SECPKG_EXTENDED_INFORMATION_CLASS ;
  478.  
  479. typedef struct _SECPKG_GSS_INFO {
  480.     ULONG   EncodedIdLength ;
  481.     UCHAR   EncodedId[4] ;
  482. } SECPKG_GSS_INFO, * PSECPKG_GSS_INFO ;
  483.  
  484. typedef struct _SECPKG_CONTEXT_THUNKS {
  485.     ULONG   InfoLevelCount ;
  486.     ULONG   Levels[1] ;
  487. } SECPKG_CONTEXT_THUNKS, *PSECPKG_CONTEXT_THUNKS ;
  488.  
  489. typedef struct _SECPKG_EXTENDED_INFORMATION {
  490.     SECPKG_EXTENDED_INFORMATION_CLASS   Class ;
  491.     union {
  492.         SECPKG_GSS_INFO         GssInfo ;
  493.         SECPKG_CONTEXT_THUNKS   ContextThunks ;
  494.     } Info ;
  495. } SECPKG_EXTENDED_INFORMATION, * PSECPKG_EXTENDED_INFORMATION ;
  496.  
  497. //
  498. // Setting this value as the first context thunk value will cause all
  499. // calls to go to the LSA:
  500. //
  501.  
  502. #define SECPKG_ATTR_THUNK_ALL   0x00010000
  503.  
  504.  
  505. //
  506. // The following prototypes are to functions that will be called only while
  507. // in the Security Package Manager context.
  508. //
  509.  
  510. typedef NTSTATUS
  511. (LSA_AP_INITIALIZE_PACKAGE) (
  512.     IN ULONG AuthenticationPackageId,
  513.     IN PLSA_DISPATCH_TABLE LsaDispatchTable,
  514.     IN PLSA_STRING Database OPTIONAL,
  515.     IN PLSA_STRING Confidentiality OPTIONAL,
  516.     OUT PLSA_STRING *AuthenticationPackageName
  517.     );
  518.  
  519. typedef NTSTATUS
  520. (LSA_AP_LOGON_USER) (
  521.     IN PLSA_CLIENT_REQUEST ClientRequest,
  522.     IN SECURITY_LOGON_TYPE LogonType,
  523.     IN PVOID AuthenticationInformation,
  524.     IN PVOID ClientAuthenticationBase,
  525.     IN ULONG AuthenticationInformationLength,
  526.     OUT PVOID *ProfileBuffer,
  527.     OUT PULONG ProfileBufferLength,
  528.     OUT PLUID LogonId,
  529.     OUT PNTSTATUS SubStatus,
  530.     OUT PLSA_TOKEN_INFORMATION_TYPE TokenInformationType,
  531.     OUT PVOID *TokenInformation,
  532.     OUT PLSA_UNICODE_STRING *AccountName,
  533.     OUT PLSA_UNICODE_STRING *AuthenticatingAuthority
  534.     );
  535.  
  536. typedef NTSTATUS
  537. (LSA_AP_LOGON_USER_EX) (
  538.     IN PLSA_CLIENT_REQUEST ClientRequest,
  539.     IN SECURITY_LOGON_TYPE LogonType,
  540.     IN PVOID AuthenticationInformation,
  541.     IN PVOID ClientAuthenticationBase,
  542.     IN ULONG AuthenticationInformationLength,
  543.     OUT PVOID *ProfileBuffer,
  544.     OUT PULONG ProfileBufferLength,
  545.     OUT PLUID LogonId,
  546.     OUT PNTSTATUS SubStatus,
  547.     OUT PLSA_TOKEN_INFORMATION_TYPE TokenInformationType,
  548.     OUT PVOID *TokenInformation,
  549.     OUT PUNICODE_STRING *AccountName,
  550.     OUT PUNICODE_STRING *AuthenticatingAuthority,
  551.     OUT PUNICODE_STRING *MachineName
  552.     );
  553.  
  554. typedef NTSTATUS
  555. (LSA_AP_CALL_PACKAGE) (
  556.     IN PLSA_CLIENT_REQUEST ClientRequest,
  557.     IN PVOID ProtocolSubmitBuffer,
  558.     IN PVOID ClientBufferBase,
  559.     IN ULONG SubmitBufferLength,
  560.     OUT PVOID *ProtocolReturnBuffer,
  561.     OUT PULONG ReturnBufferLength,
  562.     OUT PNTSTATUS ProtocolStatus
  563.     );
  564.  
  565. typedef VOID
  566. (LSA_AP_LOGON_TERMINATED) (
  567.     IN PLUID LogonId
  568.     );
  569.  
  570. typedef LSA_AP_CALL_PACKAGE LSA_AP_CALL_PACKAGE_UNTRUSTED;
  571.  
  572.  
  573. typedef NTSTATUS
  574. (NTAPI SpInitializeFn)(
  575.     IN ULONG PackageId,
  576.     IN PSECPKG_PARAMETERS Parameters,
  577.     IN PLSA_SECPKG_FUNCTION_TABLE FunctionTable
  578.     );
  579.  
  580. typedef NTSTATUS
  581. (NTAPI SpShutdownFn)(
  582.     VOID
  583.     );
  584.  
  585. typedef NTSTATUS
  586. (NTAPI SpGetInfoFn)(
  587.     OUT PSecPkgInfo PackageInfo
  588.     );
  589.  
  590. typedef NTSTATUS
  591. (NTAPI SpGetExtendedInformationFn)(
  592.     IN  SECPKG_EXTENDED_INFORMATION_CLASS Class,
  593.     OUT PSECPKG_EXTENDED_INFORMATION * ppInformation
  594.     );
  595.  
  596. typedef NTSTATUS
  597. (LSA_AP_LOGON_USER_EX2) (
  598.     IN PLSA_CLIENT_REQUEST ClientRequest,
  599.     IN SECURITY_LOGON_TYPE LogonType,
  600.     IN PVOID AuthenticationInformation,
  601.     IN PVOID ClientAuthenticationBase,
  602.     IN ULONG AuthenticationInformationLength,
  603.     OUT PVOID *ProfileBuffer,
  604.     OUT PULONG ProfileBufferLength,
  605.     OUT PLUID LogonId,
  606.     OUT PNTSTATUS SubStatus,
  607.     OUT PLSA_TOKEN_INFORMATION_TYPE TokenInformationType,
  608.     OUT PVOID *TokenInformation,
  609.     OUT PUNICODE_STRING *AccountName,
  610.     OUT PUNICODE_STRING *AuthenticatingAuthority,
  611.     OUT PUNICODE_STRING *MachineName,
  612.     OUT PSECPKG_PRIMARY_CRED PrimaryCredentials,
  613.     OUT PULONG CachedCredentialCount,
  614.     OUT PSECPKG_SUPPLEMENTAL_CRED * CachedCredentials
  615.     );
  616.  
  617. typedef LSA_AP_LOGON_USER_EX2 *PLSA_AP_LOGON_USER_EX2;
  618. #define LSA_AP_NAME_LOGON_USER_EX2 "LsaApLogonUserEx2\0"
  619.  
  620. typedef NTSTATUS
  621. (NTAPI SpAcceptCredentialsFn)(
  622.     IN SECURITY_LOGON_TYPE LogonType,
  623.     IN PUNICODE_STRING AccountName,
  624.     IN PSECPKG_PRIMARY_CRED PrimaryCredentials,
  625.     IN PSECPKG_SUPPLEMENTAL_CRED SupplementalCredentials
  626.     );
  627. #define SP_ACCEPT_CREDENTIALS_NAME "SpAcceptCredentials\0"
  628.  
  629. typedef NTSTATUS
  630. (NTAPI SpAcquireCredentialsHandleFn)(
  631.     IN OPTIONAL PUNICODE_STRING PrincipalName,
  632.     IN ULONG CredentialUseFlags,
  633.     IN OPTIONAL PLUID LogonId,
  634.     IN PVOID AuthorizationData,
  635.     IN PVOID GetKeyFunciton,
  636.     IN PVOID GetKeyArgument,
  637.     OUT PULONG CredentialHandle,
  638.     OUT PTimeStamp ExpirationTime
  639.     );
  640.  
  641. typedef NTSTATUS
  642. (NTAPI SpFreeCredentialsHandleFn)(
  643.     IN ULONG CredentialHandle
  644.     );
  645.  
  646. typedef NTSTATUS
  647. (NTAPI SpQueryCredentialsAttributesFn)(
  648.     IN ULONG CredentialHandle,
  649.     IN ULONG CredentialAttribute,
  650.     IN OUT PVOID Buffer
  651.     );
  652.  
  653. typedef NTSTATUS
  654. (NTAPI SpSaveCredentialsFn)(
  655.     IN ULONG CredentialHandle,
  656.     IN PSecBuffer Credentials);
  657.  
  658. typedef NTSTATUS
  659. (NTAPI SpGetCredentialsFn)(
  660.     IN ULONG CredentialHandle,
  661.     IN OUT PSecBuffer Credentials
  662.     );
  663.  
  664. typedef NTSTATUS
  665. (NTAPI SpDeleteCredentialsFn)(
  666.     IN ULONG CredentialHandle,
  667.     IN PSecBuffer Key
  668.     );
  669.  
  670. typedef NTSTATUS
  671. (NTAPI SpInitLsaModeContextFn)(
  672.     IN OPTIONAL ULONG CredentialHandle,
  673.     IN OPTIONAL ULONG ContextHandle,
  674.     IN OPTIONAL PUNICODE_STRING TargetName,
  675.     IN ULONG ContextRequirements,
  676.     IN ULONG TargetDataRep,
  677.     IN PSecBufferDesc InputBuffers,
  678.     OUT PULONG NewContextHandle,
  679.     IN OUT PSecBufferDesc OutputBuffers,
  680.     OUT PULONG ContextAttributes,
  681.     OUT PTimeStamp ExpirationTime,
  682.     OUT PBOOLEAN MappedContext,
  683.     OUT PSecBuffer ContextData
  684.     );
  685.  
  686.  
  687.  
  688.  
  689. typedef NTSTATUS
  690. (NTAPI SpDeleteContextFn)(
  691.     IN ULONG ContextHandle
  692.     );
  693.  
  694. typedef NTSTATUS
  695. (NTAPI SpApplyControlTokenFn)(
  696.     IN ULONG ContextHandle,
  697.     IN PSecBufferDesc ControlToken);
  698.  
  699.  
  700. typedef NTSTATUS
  701. (NTAPI SpAcceptLsaModeContextFn)(
  702.     IN OPTIONAL ULONG CredentialHandle,
  703.     IN OPTIONAL ULONG ContextHandle,
  704.     IN PSecBufferDesc InputBuffer,
  705.     IN ULONG ContextRequirements,
  706.     IN ULONG TargetDataRep,
  707.     OUT PULONG NewContextHandle,
  708.     OUT PSecBufferDesc OutputBuffer,
  709.     OUT PULONG ContextAttributes,
  710.     OUT PTimeStamp ExpirationTime,
  711.     OUT PBOOLEAN MappedContext,
  712.     OUT PSecBuffer ContextData
  713.     );
  714.  
  715.  
  716.  
  717.  
  718. typedef NTSTATUS
  719. (NTAPI SpGetUserInfoFn)(
  720.     IN PLUID LogonId,
  721.     IN ULONG Flags,
  722.     OUT PSecurityUserData * UserData
  723.     );
  724.  
  725. typedef NTSTATUS
  726. (NTAPI SpQueryContextAttributesFn)(
  727.     IN ULONG ContextHandle,
  728.     IN ULONG ContextAttribute,
  729.     IN OUT PVOID Buffer);
  730.  
  731.  
  732. typedef struct _SECPKG_FUNCTION_TABLE {
  733.     PLSA_AP_INITIALIZE_PACKAGE InitializePackage;
  734.     PLSA_AP_LOGON_USER LogonUser;
  735.     PLSA_AP_CALL_PACKAGE CallPackage;
  736.     PLSA_AP_LOGON_TERMINATED LogonTerminated;
  737.     PLSA_AP_CALL_PACKAGE_UNTRUSTED CallPackageUntrusted;
  738.     PLSA_AP_LOGON_USER_EX LogonUserEx;
  739.     PLSA_AP_LOGON_USER_EX2 LogonUserEx2;
  740.     SpInitializeFn * Initialize;
  741.     SpShutdownFn * Shutdown;
  742.     SpGetInfoFn * GetInfo;
  743.     SpAcceptCredentialsFn * AcceptCredentials;
  744.     SpAcquireCredentialsHandleFn * AcquireCredentialsHandle;
  745.     SpQueryCredentialsAttributesFn * QueryCredentialsAttributes;
  746.     SpFreeCredentialsHandleFn * FreeCredentialsHandle;
  747.     SpSaveCredentialsFn * SaveCredentials;
  748.     SpGetCredentialsFn * GetCredentials;
  749.     SpDeleteCredentialsFn * DeleteCredentials;
  750.     SpInitLsaModeContextFn * InitLsaModeContext;
  751.     SpAcceptLsaModeContextFn * AcceptLsaModeContext;
  752.     SpDeleteContextFn * DeleteContext;
  753.     SpApplyControlTokenFn * ApplyControlToken;
  754.     SpGetUserInfoFn * GetUserInfo;
  755.     SpGetExtendedInformationFn * GetExtendedInformation ;
  756.     SpQueryContextAttributesFn * QueryContextAttributes ;
  757. } SECPKG_FUNCTION_TABLE, *PSECPKG_FUNCTION_TABLE;
  758.  
  759. //
  760. // The following prototypes are to functions that will be called while in the
  761. // context of a user process that is using the functions through the security
  762. // DLL.
  763. //
  764.  
  765. typedef NTSTATUS
  766. (NTAPI SpInstanceInitFn)(
  767.     IN ULONG Version,
  768.     IN PSECPKG_DLL_FUNCTIONS FunctionTable,
  769.     OUT PVOID * UserFunctions
  770.     );
  771.  
  772.  
  773. typedef NTSTATUS
  774. (NTAPI SpInitUserModeContextFn)(
  775.     IN ULONG ContextHandle,
  776.     IN PSecBuffer PackedContext
  777.     );
  778.  
  779. typedef NTSTATUS
  780. (NTAPI SpMakeSignatureFn)(
  781.     IN ULONG ContextHandle,
  782.     IN ULONG QualityOfProtection,
  783.     IN PSecBufferDesc MessageBuffers,
  784.     IN ULONG MessageSequenceNumber
  785.     );
  786.  
  787. typedef NTSTATUS
  788. (NTAPI SpVerifySignatureFn)(
  789.     IN ULONG ContextHandle,
  790.     IN PSecBufferDesc MessageBuffers,
  791.     IN ULONG MessageSequenceNumber,
  792.     OUT PULONG QualityOfProtection
  793.     );
  794.  
  795. typedef NTSTATUS
  796. (NTAPI SpSealMessageFn)(
  797.     IN ULONG ContextHandle,
  798.     IN ULONG QualityOfProtection,
  799.     IN PSecBufferDesc MessageBuffers,
  800.     IN ULONG MessageSequenceNumber
  801.     );
  802.  
  803. typedef NTSTATUS
  804. (NTAPI SpUnsealMessageFn)(
  805.     IN ULONG ContextHandle,
  806.     IN PSecBufferDesc MessageBuffers,
  807.     IN ULONG MessageSequenceNumber,
  808.     OUT PULONG QualityOfProtection
  809.     );
  810.  
  811.  
  812. typedef NTSTATUS
  813. (NTAPI SpGetContextTokenFn)(
  814.     IN ULONG ContextHandle,
  815.     OUT PHANDLE ImpersonationToken
  816.     );
  817.  
  818.  
  819. typedef NTSTATUS
  820. (NTAPI SpExportSecurityContextFn)(
  821.     ULONG                phContext,             // (in) context to export
  822.     ULONG                fFlags,                // (in) option flags
  823.     PSecBuffer           pPackedContext,        // (out) marshalled context
  824.     PHANDLE              pToken                 // (out, optional) token handle for impersonation
  825.     );
  826.  
  827. typedef NTSTATUS
  828. (NTAPI SpImportSecurityContextFn)(
  829.     PSecBuffer           pPackedContext,        // (in) marshalled context
  830.     HANDLE               Token,                 // (in, optional) handle to token for context
  831.     PULONG               phContext              // (out) new context handle
  832.     );
  833.  
  834.  
  835. typedef NTSTATUS
  836. (NTAPI SpCompleteAuthTokenFn)(
  837.     IN ULONG ContextHandle,
  838.     IN PSecBufferDesc InputBuffer
  839.     );
  840.  
  841.  
  842. typedef NTSTATUS
  843. (NTAPI SpFormatCredentialsFn)(
  844.     IN PSecBuffer Credentials,
  845.     OUT PSecBuffer FormattedCredentials
  846.     );
  847.  
  848. typedef NTSTATUS
  849. (NTAPI SpMarshallSupplementalCredsFn)(
  850.     IN ULONG CredentialSize,
  851.     IN PUCHAR Credentials,
  852.     OUT PULONG MarshalledCredSize,
  853.     OUT PVOID * MarshalledCreds);
  854.  
  855.  
  856. typedef struct _SECPKG_USER_FUNCTION_TABLE {
  857.     SpInstanceInitFn *                      InstanceInit;
  858.     SpInitUserModeContextFn *               InitUserModeContext;
  859.     SpMakeSignatureFn *                     MakeSignature;
  860.     SpVerifySignatureFn *                   VerifySignature;
  861.     SpSealMessageFn *                       SealMessage;
  862.     SpUnsealMessageFn *                     UnsealMessage;
  863.     SpGetContextTokenFn *                   GetContextToken;
  864.     SpQueryContextAttributesFn *            QueryContextAttributes;
  865.     SpCompleteAuthTokenFn *                 CompleteAuthToken;
  866.     SpDeleteContextFn *                     DeleteUserModeContext;
  867.     SpFormatCredentialsFn *                 FormatCredentials;
  868.     SpMarshallSupplementalCredsFn *         MarshallSupplementalCreds;
  869.     SpExportSecurityContextFn *             ExportContext;
  870.     SpImportSecurityContextFn *             ImportContext;
  871. } SECPKG_USER_FUNCTION_TABLE, *PSECPKG_USER_FUNCTION_TABLE;
  872.  
  873. typedef NTSTATUS
  874. (SEC_ENTRY * SpLsaModeInitializeFn)(
  875.     IN ULONG LsaVersion,
  876.     OUT PULONG PackageVersion,
  877.     OUT PSECPKG_FUNCTION_TABLE * ppTables,
  878.     OUT PULONG pcTables);
  879.  
  880. typedef NTSTATUS
  881. (SEC_ENTRY * SpUserModeInitializeFn)(
  882.     IN ULONG LsaVersion,
  883.     OUT PULONG PackageVersion,
  884.     OUT PSECPKG_USER_FUNCTION_TABLE *ppTables,
  885.     OUT PULONG pcTables
  886.     );
  887.  
  888.  
  889.  
  890. #define SECPKG_LSAMODEINIT_NAME     "SpLsaModeInitialize"
  891. #define SECPKG_USERMODEINIT_NAME    "SpUserModeInitialize"
  892.  
  893. #define SECPKG_INTERFACE_VERSION    0x00010000
  894.  
  895.  
  896.  
  897. typedef struct _SECPKG_KERNEL_FUNCTIONS {
  898.     PLSA_ALLOCATE_LSA_HEAP AllocateHeap;
  899.     PLSA_FREE_LSA_HEAP FreeHeap;
  900. } SECPKG_KERNEL_FUNCTIONS, *PSECPKG_KERNEL_FUNCTIONS;
  901.  
  902. typedef NTSTATUS
  903. (NTAPI KspInitPackageFn)(
  904.     PSECPKG_KERNEL_FUNCTIONS    FunctionTable
  905.     );
  906.  
  907. typedef NTSTATUS
  908. (NTAPI KspDeleteContextFn)(
  909.     IN ULONG ContextId,
  910.     OUT PULONG LsaContextId
  911.     );
  912.  
  913. typedef NTSTATUS
  914. (NTAPI KspInitContextFn)(
  915.     IN ULONG ContextId,
  916.     IN PSecBuffer ContextData,
  917.     OUT PULONG NewContextId
  918.     );
  919.  
  920. typedef NTSTATUS
  921. (NTAPI KspMakeSignatureFn)(
  922.     IN ULONG ContextId,
  923.     IN ULONG fQOP,
  924.     IN OUT PSecBufferDesc Message,
  925.     IN ULONG MessageSeqNo
  926.     );
  927.  
  928. typedef NTSTATUS
  929. (NTAPI KspVerifySignatureFn)(
  930.     IN ULONG ContextId,
  931.     IN OUT PSecBufferDesc Message,
  932.     IN ULONG MessageSeqNo,
  933.     OUT PULONG pfQOP
  934.     );
  935.  
  936.  
  937. typedef NTSTATUS
  938. (NTAPI KspSealMessageFn)(
  939.     IN ULONG ContextId,
  940.     IN ULONG fQOP,
  941.     IN OUT PSecBufferDesc Message,
  942.     IN ULONG MessageSeqNo
  943.     );
  944.  
  945. typedef NTSTATUS
  946. (NTAPI KspUnsealMessageFn)(
  947.     IN ULONG ContextId,
  948.     IN OUT PSecBufferDesc Message,
  949.     IN ULONG MessageSeqNo,
  950.     OUT PULONG pfQOP
  951.     );
  952.  
  953. typedef NTSTATUS
  954. (NTAPI KspGetTokenFn)(
  955.     IN ULONG ContextId,
  956.     OUT PHANDLE ImpersonationToken,
  957.     OUT OPTIONAL PACCESS_TOKEN * RawToken
  958.     );
  959.  
  960. typedef NTSTATUS
  961. (NTAPI KspQueryAttributesFn)(
  962.     IN ULONG ContextId,
  963.     IN ULONG Attribute,
  964.     IN OUT PVOID Buffer
  965.     );
  966.  
  967. typedef NTSTATUS
  968. (NTAPI KspCompleteTokenFn)(
  969.     IN ULONG ContextId,
  970.     IN PSecBufferDesc Token
  971.     );
  972.  
  973.  
  974. typedef NTSTATUS
  975. (NTAPI KspMapHandleFn)(
  976.     IN ULONG ContextId,
  977.     OUT PULONG LsaContextId
  978.     );
  979.  
  980. typedef struct _SECPKG_KERNEL_FUNCTION_TABLE {
  981.     KspInitPackageFn *      Initialize;
  982.     KspDeleteContextFn *    DeleteContext;
  983.     KspInitContextFn *      InitContext;
  984.     KspMapHandleFn *        MapHandle;
  985.     KspMakeSignatureFn *    Sign;
  986.     KspVerifySignatureFn *  Verify;
  987.     KspSealMessageFn *      Seal;
  988.     KspUnsealMessageFn *    Unseal;
  989.     KspGetTokenFn *         GetToken;
  990.     KspQueryAttributesFn *  QueryAttributes;
  991.     KspCompleteTokenFn *    CompleteToken;
  992. } SECPKG_KERNEL_FUNCTION_TABLE, *PSECPKG_KERNEL_FUNCTION_TABLE;
  993.  
  994. SECURITY_STATUS
  995. SEC_ENTRY
  996. KsecRegisterSecurityProvider(
  997.     PSECURITY_STRING    ProviderName,
  998.     PSECPKG_KERNEL_FUNCTION_TABLE Table
  999.     );
  1000.  
  1001.  
  1002. extern SECPKG_KERNEL_FUNCTIONS KspKernelFunctions;
  1003.  
  1004.  
  1005. //
  1006. // Common types used by negotiable security packages
  1007. //
  1008.  
  1009. #define SEC_WINNT_AUTH_IDENTITY_MARSHALLED      0x4
  1010. #define SEC_WINNT_AUTH_IDENTITY_EXTENDED        0x8
  1011.  
  1012. #endif // __SECPKG_H__
  1013.