include/wintrust.h

   1 /*
   2  * Copyright (C) 2004 Francois Gouget
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 #ifndef __WINE_WINTRUST_H
  20 #define __WINE_WINTRUST_H
  21
  22 #include <wincrypt.h>
  23
  24
  25 #include <pshpack8.h>
  26
  27 typedef struct WINTRUST_FILE_INFO_
  28 {
  29     DWORD   cbStruct;
  30     LPCWSTR pcwszFilePath;
  31     HANDLE  hFile;
  32     GUID*   pgKnownSubject;
  33 } WINTRUST_FILE_INFO, *PWINTRUST_FILE_INFO;
  34
  35 typedef struct WINTRUST_CATALOG_INFO_
  36 {
  37     DWORD         cbStruct;
  38     DWORD         dwCatalogVersion;
  39     LPCWSTR       pcwszCatalogFilePath;
  40     LPCWSTR       pcwszMemberTag;
  41     LPCWSTR       pcwszMemberFilePath;
  42     HANDLE        hMemberFile;
  43     BYTE*         pbCalculatedFileHash;
  44     DWORD         cbCalculatedFileHash;
  45     PCCTL_CONTEXT pcCatalogContext;
  46 } WINTRUST_CATALOG_INFO, *PWINTRUST_CATALOG_INFO;
  47
  48 typedef struct WINTRUST_BLOB_INFO_
  49 {
  50     DWORD   cbStruct;
  51     GUID    gSubject;
  52     LPCWSTR pcwszDisplayName;
  53     DWORD   cbMemObject;
  54     BYTE*   pbMemObject;
  55     DWORD   cbMemSignedMsg;
  56     BYTE*   pbMemSignedMsg;
  57 } WINTRUST_BLOB_INFO, *PWINTRUST_BLOB_INFO;
  58
  59 typedef struct WINTRUST_SGNR_INFO_
  60 {
  61     DWORD             cbStruct;
  62     LPCWSTR           pcwszDisplayName;
  63     CMSG_SIGNER_INFO* psSignerInfo;
  64     DWORD             chStores;
  65     HCERTSTORE*       pahStores;
  66 } WINTRUST_SGNR_INFO, *PWINTRUST_SGNR_INFO;
  67
  68 typedef struct WINTRUST_CERT_INFO_
  69 {
  70     DWORD         cbStruct;
  71     LPCWSTR       pcwszDisplayName;
  72     CERT_CONTEXT* psCertContext;
  73     DWORD         chStores;
  74     HCERTSTORE*   pahStores;
  75     DWORD         dwFlags;
  76     FILETIME*     psftVerifyAsOf;
  77 } WINTRUST_CERT_INFO, *PWINTRUST_CERT_INFO;
  78
  79 /* dwUIChoice */
  80 #define WTD_UI_ALL                1
  81 #define WTD_UI_NONE               2
  82 #define WTD_UI_NOBAD              3
  83 #define WTD_UI_NOGOOD             4
  84 /* fdwRevocationChecks */
  85 #define WTD_REVOKE_NONE           0
  86 #define WTD_REVOKE_WHOLECHAIN     1
  87 /* dwUnionChoice */
  88 #define WTD_CHOICE_FILE           1
  89 #define WTD_CHOICE_CATALOG        2
  90 #define WTD_CHOICE_BLOB           3
  91 #define WTD_CHOICE_SIGNER         4
  92 #define WTD_CHOICE_CERT           5
  93
  94 typedef struct _WINTRUST_DATA
  95 {
  96     DWORD  cbStruct;
  97     LPVOID pPolicyCallbackData;
  98     LPVOID pSIPClientData;
  99     DWORD  dwUIChoice;
 100     DWORD  fdwRevocationChecks;
 101     DWORD  dwUnionChoice;
 102     union
 103     {
 104         struct WINTRUST_FILE_INFO_*    pFile;
 105         struct WINTRUST_CATALOG_INFO_* pCatalog;
 106         struct WINTRUST_BLOB_INFO_*    pBlob;
 107         struct WINTRUST_SGNR_INFO_*    pSgnr;
 108         struct WINTRUST_CERT_INFO_*    pCert;
 109     } DUMMYUNIONNAME;
 110
 111     DWORD  dwStateAction;
 112     HANDLE hWVTStateData;
 113     WCHAR* pwszURLReference;
 114     DWORD  dwProvFlags;
 115     DWORD  dwUIContext;
 116 } WINTRUST_DATA, *PWINTRUST_DATA;
 117
 118 typedef struct _CRYPT_TRUST_REG_ENTRY
 119 {
 120     DWORD cbStruct;
 121     WCHAR *pwszDLLName;
 122     WCHAR *pwszFunctionName;
 123 } CRYPT_TRUST_REG_ENTRY, *PCRYPT_TRUST_REG_ENTRY;
 124
 125 typedef struct _CRYPT_REGISTER_ACTIONID
 126 {
 127     DWORD cbStruct;
 128     CRYPT_TRUST_REG_ENTRY sInitProvider;
 129     CRYPT_TRUST_REG_ENTRY sObjectProvider;
 130     CRYPT_TRUST_REG_ENTRY sSignatureProvider;
 131     CRYPT_TRUST_REG_ENTRY sCertificateProvider;
 132     CRYPT_TRUST_REG_ENTRY sCertificatePolicyProvider;
 133     CRYPT_TRUST_REG_ENTRY sFinalPolicyProvider;
 134     CRYPT_TRUST_REG_ENTRY sTestPolicyProvider;
 135     CRYPT_TRUST_REG_ENTRY sCleanupProvider;
 136 } CRYPT_REGISTER_ACTIONID, *PCRYPT_REGISTER_ACTIONID;
 137
 138 typedef struct _CRYPT_PROVIDER_REGDEFUSAGE
 139 {
 140     DWORD cbStruct;
 141     GUID  *pgActionID;
 142     WCHAR *pwszDllName;
 143     char  *pwszLoadCallbackDataFunctionName;
 144     char  *pwszFreeCallbackDataFunctionName;
 145 } CRYPT_PROVIDER_REGDEFUSAGE, *PCRYPT_PROVIDER_REGDEFUSAGE;
 146
 147 typedef struct _CRYPT_PROVUI_DATA {
 148     DWORD cbStruct;
 149     DWORD dwFinalError;
 150     WCHAR *pYesButtonText;
 151     WCHAR *pNoButtonText;
 152     WCHAR *pMoreInfoButtonText;
 153     WCHAR *pAdvancedLinkText;
 154     WCHAR *pCopyActionText;
 155     WCHAR *pCopyActionTextNoTS;
 156     WCHAR *pCopyActionTextNotSigned;
 157 } CRYPT_PROVUI_DATA, *PCRYPT_PROVUI_DATA;
 158
 159 typedef struct _CRYPT_PROVIDER_CERT {
 160     DWORD               cbStruct;
 161     PCCERT_CONTEXT      pCert;
 162     BOOL                fCommercial;
 163     BOOL                fTrustedRoot;
 164     BOOL                fSelfSigned;
 165     BOOL                fTestCert;
 166     DWORD               dwRevokedReason;
 167     DWORD               dwConfidence;
 168     DWORD               dwError;
 169     CTL_CONTEXT        *pTrustListContext;
 170     BOOL                fTrustListSignerCert;
 171     PCCTL_CONTEXT       pCtlContext;
 172     DWORD               dwCtlError;
 173     BOOL                fIsCyclic;
 174     PCERT_CHAIN_ELEMENT pChainElement;
 175 } CRYPT_PROVIDER_CERT, *PCRYPT_PROVIDER_CERT;
 176
 177 typedef struct _CRYPT_PROVIDER_SGNR {
 178     DWORD                cbStruct;
 179     FILETIME             sftVerifyAsOf;
 180     DWORD                csCertChain;
 181     CRYPT_PROVIDER_CERT *pasCertChain;
 182     DWORD                dwSignerType;
 183     CMSG_SIGNER_INFO    *psSigner;
 184     DWORD                dwError;
 185     DWORD                csCounterSigners;
 186     struct _CRYPT_PROVIDER_SGNR *pasCounterSigners;
 187     PCCERT_CHAIN_CONTEXT pChainContext;
 188 } CRYPT_PROVIDER_SGNR, *PCRYPT_PROVIDER_SGNR;
 189
 190 typedef struct _CRYPT_PROVIDER_PRIVDATA {
 191     DWORD cbStruct;
 192     GUID  gProviderID;
 193     DWORD cbProvData;
 194     void *pvProvData;
 195 } CRYPT_PROVIDER_PRIVDATA, *PCRYPT_PROVIDER_PRIVDATA;
 196
 197 struct _CRYPT_PROVIDER_DATA;
 198
 199 typedef void * (*PFN_CPD_MEM_ALLOC)(DWORD cbSize);
 200 typedef void (*PFN_CPD_MEM_FREE)(void *pvMem2Free);
 201 typedef BOOL (*PFN_CPD_ADD_STORE)(struct _CRYPT_PROVIDER_DATA *pProvData,
 202  HCERTSTORE hStore2Add);
 203 typedef BOOL (*PFN_CPD_ADD_SGNR)(struct _CRYPT_PROVIDER_DATA *pProvData,
 204  BOOL fCounterSigner, DWORD idxSigner, struct _CRYPT_PROVIDER_SGNR *pSgnr2Add);
 205 typedef BOOL (*PFN_CPD_ADD_CERT)(struct _CRYPT_PROVIDER_DATA *pProvData,
 206  DWORD idxSigner, BOOL fCounterSigner, DWORD idxCounterSigner,
 207  PCCERT_CONTEXT pCert2Add);
 208 typedef BOOL (*PFN_CPD_ADD_PRIVDATA)(struct _CRYPT_PROVIDER_DATA *pProvData,
 209  struct _CRYPT_PROVIDER_PRIVDATA *pPrivData2Add);
 210 typedef HRESULT (*PFN_PROVIDER_INIT_CALL)(
 211  struct _CRYPT_PROVIDER_DATA *pProvData);
 212 typedef HRESULT (*PFN_PROVIDER_OBJTRUST_CALL)(
 213  struct _CRYPT_PROVIDER_DATA *pProvData);
 214 typedef HRESULT (*PFN_PROVIDER_SIGTRUST_CALL)(
 215  struct _CRYPT_PROVIDER_DATA *pProvData);
 216 typedef HRESULT (*PFN_PROVIDER_CERTTTRUST_CALL)(
 217  struct _CRYPT_PROVIDER_DATA *pProvData);
 218 typedef HRESULT (*PFN_PROVIDER_FINALPOLICY_CALL)(
 219  struct _CRYPT_PROVIDER_DATA *pProvData);
 220 typedef HRESULT (*PFN_PROVIDER_TESTFINALPOLICY_CALL)(
 221  struct _CRYPT_PROVIDER_DATA *pProvData);
 222 typedef HRESULT (*PFN_PROVIDER_CLEANUP_CALL)(
 223  struct _CRYPT_PROVIDER_DATA *pProvData);
 224 typedef BOOL (*PFN_PROVIDER_CERTCHKPOLICY_CALL)(
 225  struct _CRYPT_PROVIDER_DATA *pProvData, DWORD idxSigner,
 226  BOOL fCounterSignerChain, DWORD idxCounterSigner);
 227
 228 typedef struct _CRYPT_PROVIDER_FUNCTIONS {
 229     DWORD cbStruct;
 230     PFN_CPD_MEM_ALLOC    pfnAlloc;
 231     PFN_CPD_MEM_FREE     pfnFree;
 232     PFN_CPD_ADD_STORE    pfnAddStore2Chain;
 233     PFN_CPD_ADD_SGNR     pfnAddSgnr2Chain;
 234     PFN_CPD_ADD_CERT     pfnAddCert2Chain;
 235     PFN_CPD_ADD_PRIVDATA pfnAddPrivData2Chain;
 236     PFN_PROVIDER_INIT_CALL            pfnInitialize;
 237     PFN_PROVIDER_OBJTRUST_CALL        pfnObjectTrust;
 238     PFN_PROVIDER_SIGTRUST_CALL        pfnSignatureTrust;
 239     PFN_PROVIDER_CERTTTRUST_CALL      pfnCertificateTrust;
 240     PFN_PROVIDER_FINALPOLICY_CALL     pfnFinalPolicy;
 241     PFN_PROVIDER_CERTCHKPOLICY_CALL   pfnCertCheckPolicy;
 242     PFN_PROVIDER_TESTFINALPOLICY_CALL pfnTestFinalPolicy;
 243     struct _CRYPT_PROVUI_FUNCS       *psUIpfns;
 244     PFN_PROVIDER_CLEANUP_CALL         pfnCleanupPolicy;
 245 } CRYPT_PROVIDER_FUNCTIONS, *PCRYPT_PROVIDER_FUNCTIONS;
 246
 247 struct SIP_DISPATCH_INFO_;
 248 struct SIP_SUBJECTINFO_;
 249 struct SIP_INDIRECT_DATA_;
 250
 251 typedef struct _PROVDATA_SIP {
 252     DWORD cbStruct;
 253     GUID  gSubject;
 254     struct SIP_DISPATCH_INFO_ *pSip;
 255     struct SIP_DISPATCH_INFO_ *pCATSip;
 256     struct SIP_SUBJECTINFO_   *psSipSubjectInfo;
 257     struct SIP_SUBJECTINFO_   *psSipCATSubjectInfo;
 258     struct SIP_INDIRECT_DATA_ *psIndirectData;
 259 } PROVDATA_SIP, *PPROVDATA_SIP;
 260
 261 typedef struct _CRYPT_PROVIDER_DATA {
 262     DWORD                     cbStruct;
 263     WINTRUST_DATA            *pWintrustData;
 264     BOOL                      fOpenedFile;
 265     HWND                      hWndParent;
 266     GUID                     *pgActionID;
 267     HCRYPTPROV                hProv;
 268     DWORD                     dwError;
 269     DWORD                     dwRegSecuritySettings;
 270     DWORD                     dwRegPolicySettings;
 271     CRYPT_PROVIDER_FUNCTIONS *psPfns;
 272     DWORD                     cdwTrustStepErrors;
 273     DWORD                    *padwTrustStepErrors;
 274     DWORD                     chStores;
 275     HCERTSTORE               *pahStores;
 276     DWORD                     dwEncoding;
 277     HCRYPTMSG                 hMsg;
 278     DWORD                     csSigners;
 279     CRYPT_PROVIDER_SGNR      *pasSigners;
 280     DWORD                     dwSubjectChoice;
 281     union {
 282         struct _PROVDATA_SIP        *pPDSip;
 283     } DUMMYUNIONNAME;
 284     char                     *pszUsageOID;
 285     BOOL                      fRecallWithState;
 286     FILETIME                  sftSystemTime;
 287     char                      *pszCTLSignerUsageOID;
 288     DWORD                     dwProvFlags;
 289     DWORD                     dwFinalError;
 290     PCERT_USAGE_MATCH         pRequestUsage;
 291     DWORD                     dwTrustPubSettings;
 292     DWORD                     dwUIStateFlags;
 293 } CRYPT_PROVIDER_DATA, *PCRYPT_PROVIDER_DATA;
 294
 295 typedef BOOL (*PFN_PROVUI_CALL)(HWND hWndSecurityDialog,
 296  struct _CRYPT_PROVIDER_DATA *pProvData);
 297
 298 typedef struct _CRYPT_PROVUI_FUNCS {
 299     DWORD cbStruct;
 300     CRYPT_PROVUI_DATA psUIData;
 301     PFN_PROVUI_CALL pfnOnMoreInfoClick;
 302     PFN_PROVUI_CALL pfnOnMoreInfoClickDefault;
 303     PFN_PROVUI_CALL pfnOnAdvancedClick;
 304     PFN_PROVUI_CALL pfnOnAdvancedClickDefault;
 305 } CRYPT_PROVUI_FUNCS, *PCRYPT_PROVUI_FUNCS;
 306
 307 #include <poppack.h>
 308
 309 #define WT_ADD_ACTION_ID_RET_RESULT_FLAG 1
 310
 311 #ifdef __cplusplus
 312 extern "C" {
 313 #endif
 314
 315 #if defined(__GNUC__)
 316 #define WT_PROVIDER_CERTTRUST_FUNCTION (const WCHAR []) \
 317     {'W','i','n','t','r','u','s','t','C','e','r','t','i','f','i','c','a','t','e','T','r','u','s','t', 0}
 318 #elif defined(_MSC_VER)
 319 #define WT_PROVIDER_CERTTRUST_FUNCTION L"WintrustCertificateTrust"
 320 #else
 321 static const WCHAR WT_PROVIDER_CERTTRUST_FUNCTION[] = \
 322     {'W','i','n','t','r','u','s','t','C','e','r','t','i','f','i','c','a','t','e','T','r','u','s','t', 0};
 323 #endif
 324
 325 BOOL      WINAPI WintrustAddActionID(GUID*,DWORD,CRYPT_REGISTER_ACTIONID*);
 326 BOOL      WINAPI WintrustRemoveActionID(GUID*);
 327 BOOL      WINAPI WintrustLoadFunctionPointers(GUID*,CRYPT_PROVIDER_FUNCTIONS*);
 328 BOOL      WINAPI WintrustAddDefaultForUsage(const CHAR*,CRYPT_PROVIDER_REGDEFUSAGE*);
 329 void      WINAPI WintrustGetRegPolicyFlags(DWORD*);
 330 LONG      WINAPI WinVerifyTrust(HWND,GUID*,LPVOID);
 331 HRESULT   WINAPI WinVerifyTrustEx(HWND,GUID*,WINTRUST_DATA*);
 332
 333 CRYPT_PROVIDER_SGNR * WINAPI WTHelperGetProvSignerFromChain(
 334  CRYPT_PROVIDER_DATA *pProvData, DWORD idxSigner, BOOL fCounterSigner,
 335  DWORD idxCounterSigner);
 336 CRYPT_PROVIDER_DATA * WINAPI WTHelperProvDataFromStateData(HANDLE hStateData);
 337
 338 #define SPC_INDIRECT_DATA_OBJID      "1.3.6.1.4.1.311.2.1.4"
 339 #define SPC_SP_AGENCY_INFO_OBJID     "1.3.6.1.4.1.311.2.1.10"
 340 #define SPC_STATEMENT_TYPE_OBJID     "1.3.6.1.4.1.311.2.1.11"
 341 #define SPC_SP_OPUS_INFO_OBJID       "1.3.6.1.4.1.311.2.1.12"
 342 #define SPC_PE_IMAGE_DATA_OBJID      "1.3.6.1.4.1.311.2.1.15"
 343 #define SPC_JAVA_CLASS_DATA_OBJID    "1.3.6.1.4.1.311.2.1.20"
 344 #define SPC_CAB_DATA_OBJID           "1.3.6.1.4.1.311.2.1.25"
 345 #define SPC_MINIMAL_CRITERIA_OBJID   "1.3.6.1.4.1.311.2.1.26"
 346 #define SPC_FINANCIAL_CRITERIA_OBJID "1.3.6.1.4.1.311.2.1.27"
 347 #define SPC_LINK_OBJID               "1.3.6.1.4.1.311.2.1.28"
 348 #define SPC_SIGINFO_OBJID            "1.3.6.1.4.1.311.2.1.30"
 349 #define CAT_NAMEVALUE_OBJID          "1.3.6.1.4.1.311.12.2.1"
 350 #define CAT_MEMBERINFO_OBJID         "1.3.6.1.4.1.311.12.2.2"
 351
 352 #define SPC_SP_AGENCY_INFO_STRUCT        ((LPCSTR) 2000)
 353 #define SPC_MINIMAL_CRITERIA_STRUCT      ((LPCSTR) 2001)
 354 #define SPC_FINANCIAL_CRITERIA_STRUCT    ((LPCSTR) 2002)
 355 #define SPC_INDIRECT_DATA_CONTENT_STRUCT ((LPCSTR) 2003)
 356 #define SPC_PE_IMAGE_DATA_STRUCT         ((LPCSTR) 2004)
 357 #define SPC_LINK_STRUCT                  ((LPCSTR) 2005)
 358 #define SPC_STATEMENT_TYPE_STRUCT        ((LPCSTR) 2006)
 359 #define SPC_SP_OPUS_INFO_STRUCT          ((LPCSTR) 2007)
 360 #define SPC_CAB_DATA_STRUCT              ((LPCSTR) 2008)
 361 #define SPC_JAVA_CLASS_DATA_STRUCT       ((LPCSTR) 2009)
 362 #define SPC_SIGINFO_STRUCT               ((LPCSTR) 2130)
 363 #define CAT_NAMEVALUE_STRUCT             ((LPCSTR) 2221)
 364 #define CAT_MEMBERINFO_STRUCT            ((LPCSTR) 2222)
 365
 366 #define WIN_SPUB_ACTION_PUBLISHED_SOFTWARE \
 367      { 0x64b9d180, 0x8da2, 0x11cf, { 0x87,0x36,0x00,0xaa,0x00,0xa4,0x85,0xeb }}
 368
 369 #ifdef __cplusplus
 370 }
 371 #endif
 372
 373 #endif