dlls/crypt32/chain.c

   1 /*
   2  * Copyright 2006 Juan Lang
   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 #include <stdarg.h>
  20 #define NONAMELESSUNION
  21 #include "windef.h"
  22 #include "winbase.h"
  23 #define CERT_CHAIN_PARA_HAS_EXTRA_FIELDS
  24 #define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS
  25 #include "wincrypt.h"
  26 #include "wine/debug.h"
  27 #include "wine/unicode.h"
  28 #include "crypt32_private.h"
  29
  30 WINE_DEFAULT_DEBUG_CHANNEL(crypt);
  31 WINE_DECLARE_DEBUG_CHANNEL(chain);
  32
  33 #define DEFAULT_CYCLE_MODULUS 7
  34
  35 static HCERTCHAINENGINE CRYPT_defaultChainEngine;
  36
  37 /* This represents a subset of a certificate chain engine:  it doesn't include
  38  * the "hOther" store described by MSDN, because I'm not sure how that's used.
  39  * It also doesn't include the "hTrust" store, because I don't yet implement
  40  * CTLs or complex certificate chains.
  41  */
  42 typedef struct _CertificateChainEngine
  43 {
  44     LONG       ref;
  45     HCERTSTORE hRoot;
  46     HCERTSTORE hWorld;
  47     DWORD      dwFlags;
  48     DWORD      dwUrlRetrievalTimeout;
  49     DWORD      MaximumCachedCertificates;
  50     DWORD      CycleDetectionModulus;
  51 } CertificateChainEngine, *PCertificateChainEngine;
  52
  53 static inline void CRYPT_AddStoresToCollection(HCERTSTORE collection,
  54  DWORD cStores, HCERTSTORE *stores)
  55 {
  56     DWORD i;
  57
  58     for (i = 0; i < cStores; i++)
  59         CertAddStoreToCollection(collection, stores[i], 0, 0);
  60 }
  61
  62 static inline void CRYPT_CloseStores(DWORD cStores, HCERTSTORE *stores)
  63 {
  64     DWORD i;
  65
  66     for (i = 0; i < cStores; i++)
  67         CertCloseStore(stores[i], 0);
  68 }
  69
  70 static const WCHAR rootW[] = { 'R','o','o','t',0 };
  71
  72 static BOOL CRYPT_CheckRestrictedRoot(HCERTSTORE store)
  73 {
  74     BOOL ret = TRUE;
  75
  76     if (store)
  77     {
  78         HCERTSTORE rootStore = CertOpenSystemStoreW(0, rootW);
  79         PCCERT_CONTEXT cert = NULL, check;
  80         BYTE hash[20];
  81         DWORD size;
  82
  83         do {
  84             cert = CertEnumCertificatesInStore(store, cert);
  85             if (cert)
  86             {
  87                 size = sizeof(hash);
  88
  89                 ret = CertGetCertificateContextProperty(cert, CERT_HASH_PROP_ID,
  90                  hash, &size);
  91                 if (ret)
  92                 {
  93                     CRYPT_HASH_BLOB blob = { sizeof(hash), hash };
  94
  95                     check = CertFindCertificateInStore(rootStore,
  96                      cert->dwCertEncodingType, 0, CERT_FIND_SHA1_HASH, &blob,
  97                      NULL);
  98                     if (!check)
  99                         ret = FALSE;
 100                     else
 101                         CertFreeCertificateContext(check);
 102                 }
 103             }
 104         } while (ret && cert);
 105         if (cert)
 106             CertFreeCertificateContext(cert);
 107         CertCloseStore(rootStore, 0);
 108     }
 109     return ret;
 110 }
 111
 112 HCERTCHAINENGINE CRYPT_CreateChainEngine(HCERTSTORE root,
 113  PCERT_CHAIN_ENGINE_CONFIG pConfig)
 114 {
 115     static const WCHAR caW[] = { 'C','A',0 };
 116     static const WCHAR myW[] = { 'M','y',0 };
 117     static const WCHAR trustW[] = { 'T','r','u','s','t',0 };
 118     PCertificateChainEngine engine =
 119      CryptMemAlloc(sizeof(CertificateChainEngine));
 120
 121     if (engine)
 122     {
 123         HCERTSTORE worldStores[4];
 124
 125         engine->ref = 1;
 126         engine->hRoot = root;
 127         engine->hWorld = CertOpenStore(CERT_STORE_PROV_COLLECTION, 0, 0,
 128          CERT_STORE_CREATE_NEW_FLAG, NULL);
 129         worldStores[0] = CertDuplicateStore(engine->hRoot);
 130         worldStores[1] = CertOpenSystemStoreW(0, caW);
 131         worldStores[2] = CertOpenSystemStoreW(0, myW);
 132         worldStores[3] = CertOpenSystemStoreW(0, trustW);
 133         CRYPT_AddStoresToCollection(engine->hWorld,
 134          sizeof(worldStores) / sizeof(worldStores[0]), worldStores);
 135         CRYPT_AddStoresToCollection(engine->hWorld,
 136          pConfig->cAdditionalStore, pConfig->rghAdditionalStore);
 137         CRYPT_CloseStores(sizeof(worldStores) / sizeof(worldStores[0]),
 138          worldStores);
 139         engine->dwFlags = pConfig->dwFlags;
 140         engine->dwUrlRetrievalTimeout = pConfig->dwUrlRetrievalTimeout;
 141         engine->MaximumCachedCertificates =
 142          pConfig->MaximumCachedCertificates;
 143         if (pConfig->CycleDetectionModulus)
 144             engine->CycleDetectionModulus = pConfig->CycleDetectionModulus;
 145         else
 146             engine->CycleDetectionModulus = DEFAULT_CYCLE_MODULUS;
 147     }
 148     return engine;
 149 }
 150
 151 BOOL WINAPI CertCreateCertificateChainEngine(PCERT_CHAIN_ENGINE_CONFIG pConfig,
 152  HCERTCHAINENGINE *phChainEngine)
 153 {
 154     BOOL ret;
 155
 156     TRACE("(%p, %p)\n", pConfig, phChainEngine);
 157
 158     if (pConfig->cbSize != sizeof(*pConfig))
 159     {
 160         SetLastError(E_INVALIDARG);
 161         return FALSE;
 162     }
 163     *phChainEngine = NULL;
 164     ret = CRYPT_CheckRestrictedRoot(pConfig->hRestrictedRoot);
 165     if (ret)
 166     {
 167         HCERTSTORE root;
 168         HCERTCHAINENGINE engine;
 169
 170         if (pConfig->hRestrictedRoot)
 171             root = CertDuplicateStore(pConfig->hRestrictedRoot);
 172         else
 173             root = CertOpenSystemStoreW(0, rootW);
 174         engine = CRYPT_CreateChainEngine(root, pConfig);
 175         if (engine)
 176         {
 177             *phChainEngine = engine;
 178             ret = TRUE;
 179         }
 180         else
 181             ret = FALSE;
 182     }
 183     return ret;
 184 }
 185
 186 VOID WINAPI CertFreeCertificateChainEngine(HCERTCHAINENGINE hChainEngine)
 187 {
 188     PCertificateChainEngine engine = (PCertificateChainEngine)hChainEngine;
 189
 190     TRACE("(%p)\n", hChainEngine);
 191
 192     if (engine && InterlockedDecrement(&engine->ref) == 0)
 193     {
 194         CertCloseStore(engine->hWorld, 0);
 195         CertCloseStore(engine->hRoot, 0);
 196         CryptMemFree(engine);
 197     }
 198 }
 199
 200 static HCERTCHAINENGINE CRYPT_GetDefaultChainEngine(void)
 201 {
 202     if (!CRYPT_defaultChainEngine)
 203     {
 204         CERT_CHAIN_ENGINE_CONFIG config = { 0 };
 205         HCERTCHAINENGINE engine;
 206
 207         config.cbSize = sizeof(config);
 208         CertCreateCertificateChainEngine(&config, &engine);
 209         InterlockedCompareExchangePointer(&CRYPT_defaultChainEngine, engine,
 210          NULL);
 211         if (CRYPT_defaultChainEngine != engine)
 212             CertFreeCertificateChainEngine(engine);
 213     }
 214     return CRYPT_defaultChainEngine;
 215 }
 216
 217 void default_chain_engine_free(void)
 218 {
 219     CertFreeCertificateChainEngine(CRYPT_defaultChainEngine);
 220 }
 221
 222 typedef struct _CertificateChain
 223 {
 224     CERT_CHAIN_CONTEXT context;
 225     HCERTSTORE world;
 226     LONG ref;
 227 } CertificateChain, *PCertificateChain;
 228
 229 static inline BOOL CRYPT_IsCertificateSelfSigned(PCCERT_CONTEXT cert)
 230 {
 231     return CertCompareCertificateName(cert->dwCertEncodingType,
 232      &cert->pCertInfo->Subject, &cert->pCertInfo->Issuer);
 233 }
 234
 235 static void CRYPT_FreeChainElement(PCERT_CHAIN_ELEMENT element)
 236 {
 237     CertFreeCertificateContext(element->pCertContext);
 238     CryptMemFree(element);
 239 }
 240
 241 static void CRYPT_CheckSimpleChainForCycles(PCERT_SIMPLE_CHAIN chain)
 242 {
 243     DWORD i, j, cyclicCertIndex = 0;
 244
 245     /* O(n^2) - I don't think there's a faster way */
 246     for (i = 0; !cyclicCertIndex && i < chain->cElement; i++)
 247         for (j = i + 1; !cyclicCertIndex && j < chain->cElement; j++)
 248             if (CertCompareCertificate(X509_ASN_ENCODING,
 249              chain->rgpElement[i]->pCertContext->pCertInfo,
 250              chain->rgpElement[j]->pCertContext->pCertInfo))
 251                 cyclicCertIndex = j;
 252     if (cyclicCertIndex)
 253     {
 254         chain->rgpElement[cyclicCertIndex]->TrustStatus.dwErrorStatus
 255          |= CERT_TRUST_IS_CYCLIC | CERT_TRUST_INVALID_BASIC_CONSTRAINTS;
 256         /* Release remaining certs */
 257         for (i = cyclicCertIndex + 1; i < chain->cElement; i++)
 258             CRYPT_FreeChainElement(chain->rgpElement[i]);
 259         /* Truncate chain */
 260         chain->cElement = cyclicCertIndex + 1;
 261     }
 262 }
 263
 264 /* Checks whether the chain is cyclic by examining the last element's status */
 265 static inline BOOL CRYPT_IsSimpleChainCyclic(PCERT_SIMPLE_CHAIN chain)
 266 {
 267     if (chain->cElement)
 268         return chain->rgpElement[chain->cElement - 1]->TrustStatus.dwErrorStatus
 269          & CERT_TRUST_IS_CYCLIC;
 270     else
 271         return FALSE;
 272 }
 273
 274 static inline void CRYPT_CombineTrustStatus(CERT_TRUST_STATUS *chainStatus,
 275  CERT_TRUST_STATUS *elementStatus)
 276 {
 277     /* Any error that applies to an element also applies to a chain.. */
 278     chainStatus->dwErrorStatus |= elementStatus->dwErrorStatus;
 279     /* but the bottom nibble of an element's info status doesn't apply to the
 280      * chain.
 281      */
 282     chainStatus->dwInfoStatus |= (elementStatus->dwInfoStatus & 0xfffffff0);
 283 }
 284
 285 static BOOL CRYPT_AddCertToSimpleChain(PCertificateChainEngine engine,
 286  PCERT_SIMPLE_CHAIN chain, PCCERT_CONTEXT cert, DWORD subjectInfoStatus)
 287 {
 288     BOOL ret = FALSE;
 289     PCERT_CHAIN_ELEMENT element = CryptMemAlloc(sizeof(CERT_CHAIN_ELEMENT));
 290
 291     if (element)
 292     {
 293         if (!chain->cElement)
 294             chain->rgpElement = CryptMemAlloc(sizeof(PCERT_CHAIN_ELEMENT));
 295         else
 296             chain->rgpElement = CryptMemRealloc(chain->rgpElement,
 297              (chain->cElement + 1) * sizeof(PCERT_CHAIN_ELEMENT));
 298         if (chain->rgpElement)
 299         {
 300             chain->rgpElement[chain->cElement++] = element;
 301             memset(element, 0, sizeof(CERT_CHAIN_ELEMENT));
 302             element->cbSize = sizeof(CERT_CHAIN_ELEMENT);
 303             element->pCertContext = CertDuplicateCertificateContext(cert);
 304             if (chain->cElement > 1)
 305                 chain->rgpElement[chain->cElement - 2]->TrustStatus.dwInfoStatus
 306                  = subjectInfoStatus;
 307             /* FIXME: initialize the rest of element */
 308             if (!(chain->cElement % engine->CycleDetectionModulus))
 309                 CRYPT_CheckSimpleChainForCycles(chain);
 310             CRYPT_CombineTrustStatus(&chain->TrustStatus,
 311              &element->TrustStatus);
 312             ret = TRUE;
 313         }
 314         else
 315             CryptMemFree(element);
 316     }
 317     return ret;
 318 }
 319
 320 static void CRYPT_FreeSimpleChain(PCERT_SIMPLE_CHAIN chain)
 321 {
 322     DWORD i;
 323
 324     for (i = 0; i < chain->cElement; i++)
 325         CRYPT_FreeChainElement(chain->rgpElement[i]);
 326     CryptMemFree(chain->rgpElement);
 327     CryptMemFree(chain);
 328 }
 329
 330 static void CRYPT_CheckTrustedStatus(HCERTSTORE hRoot,
 331  PCERT_CHAIN_ELEMENT rootElement)
 332 {
 333     BYTE hash[20];
 334     DWORD size = sizeof(hash);
 335     CRYPT_HASH_BLOB blob = { sizeof(hash), hash };
 336     PCCERT_CONTEXT trustedRoot;
 337
 338     CertGetCertificateContextProperty(rootElement->pCertContext,
 339      CERT_HASH_PROP_ID, hash, &size);
 340     trustedRoot = CertFindCertificateInStore(hRoot,
 341      rootElement->pCertContext->dwCertEncodingType, 0, CERT_FIND_SHA1_HASH,
 342      &blob, NULL);
 343     if (!trustedRoot)
 344         rootElement->TrustStatus.dwErrorStatus |=
 345          CERT_TRUST_IS_UNTRUSTED_ROOT;
 346     else
 347         CertFreeCertificateContext(trustedRoot);
 348 }
 349
 350 static void CRYPT_CheckRootCert(HCERTCHAINENGINE hRoot,
 351  PCERT_CHAIN_ELEMENT rootElement)
 352 {
 353     PCCERT_CONTEXT root = rootElement->pCertContext;
 354
 355     if (!CryptVerifyCertificateSignatureEx(0, root->dwCertEncodingType,
 356      CRYPT_VERIFY_CERT_SIGN_SUBJECT_CERT, (void *)root,
 357      CRYPT_VERIFY_CERT_SIGN_ISSUER_CERT, (void *)root, 0, NULL))
 358     {
 359         TRACE_(chain)("Last certificate's signature is invalid\n");
 360         rootElement->TrustStatus.dwErrorStatus |=
 361          CERT_TRUST_IS_NOT_SIGNATURE_VALID;
 362     }
 363     CRYPT_CheckTrustedStatus(hRoot, rootElement);
 364 }
 365
 366 /* Decodes a cert's basic constraints extension (either szOID_BASIC_CONSTRAINTS
 367  * or szOID_BASIC_CONSTRAINTS2, whichever is present) into a
 368  * CERT_BASIC_CONSTRAINTS2_INFO.  If it neither extension is present, sets
 369  * constraints->fCA to defaultIfNotSpecified.
 370  * Returns FALSE if the extension is present but couldn't be decoded.
 371  */
 372 static BOOL CRYPT_DecodeBasicConstraints(PCCERT_CONTEXT cert,
 373  CERT_BASIC_CONSTRAINTS2_INFO *constraints, BOOL defaultIfNotSpecified)
 374 {
 375     BOOL ret = TRUE;
 376     PCERT_EXTENSION ext = CertFindExtension(szOID_BASIC_CONSTRAINTS,
 377      cert->pCertInfo->cExtension, cert->pCertInfo->rgExtension);
 378
 379     constraints->fPathLenConstraint = FALSE;
 380     if (ext)
 381     {
 382         CERT_BASIC_CONSTRAINTS_INFO *info;
 383         DWORD size = 0;
 384
 385         ret = CryptDecodeObjectEx(X509_ASN_ENCODING, szOID_BASIC_CONSTRAINTS,
 386          ext->Value.pbData, ext->Value.cbData, CRYPT_DECODE_ALLOC_FLAG,
 387          NULL, &info, &size);
 388         if (ret)
 389         {
 390             if (info->SubjectType.cbData == 1)
 391                 constraints->fCA =
 392                  info->SubjectType.pbData[0] & CERT_CA_SUBJECT_FLAG;
 393             LocalFree(info);
 394         }
 395     }
 396     else
 397     {
 398         ext = CertFindExtension(szOID_BASIC_CONSTRAINTS2,
 399          cert->pCertInfo->cExtension, cert->pCertInfo->rgExtension);
 400         if (ext)
 401         {
 402             DWORD size = sizeof(CERT_BASIC_CONSTRAINTS2_INFO);
 403
 404             ret = CryptDecodeObjectEx(X509_ASN_ENCODING,
 405              szOID_BASIC_CONSTRAINTS2, ext->Value.pbData, ext->Value.cbData,
 406              0, NULL, constraints, &size);
 407         }
 408         else
 409             constraints->fCA = defaultIfNotSpecified;
 410     }
 411     return ret;
 412 }
 413
 414 /* Checks element's basic constraints to see if it can act as a CA, with
 415  * remainingCAs CAs left in this chain.  A root certificate is assumed to be
 416  * allowed to be a CA whether or not the basic constraints extension is present,
 417  * whereas an intermediate CA cert is not.  This matches the expected usage in
 418  * RFC 3280:  a conforming intermediate CA MUST contain the basic constraints
 419  * extension.  It also appears to match Microsoft's implementation.
 420  * Updates chainConstraints with the element's constraints, if:
 421  * 1. chainConstraints doesn't have a path length constraint, or
 422  * 2. element's path length constraint is smaller than chainConstraints's
 423  * Sets *pathLengthConstraintViolated to TRUE if a path length violation
 424  * occurs.
 425  * Returns TRUE if the element can be a CA, and the length of the remaining
 426  * chain is valid.
 427  */
 428 static BOOL CRYPT_CheckBasicConstraintsForCA(PCCERT_CONTEXT cert,
 429  CERT_BASIC_CONSTRAINTS2_INFO *chainConstraints, DWORD remainingCAs,
 430  BOOL isRoot, BOOL *pathLengthConstraintViolated)
 431 {
 432     BOOL validBasicConstraints;
 433     CERT_BASIC_CONSTRAINTS2_INFO constraints;
 434
 435     if ((validBasicConstraints = CRYPT_DecodeBasicConstraints(cert,
 436      &constraints, isRoot)))
 437     {
 438         if (!constraints.fCA)
 439         {
 440             TRACE_(chain)("chain element %d can't be a CA\n", remainingCAs + 1);
 441             validBasicConstraints = FALSE;
 442         }
 443         else if (constraints.fPathLenConstraint)
 444         {
 445             /* If the element has path length constraints, they apply to the
 446              * entire remaining chain.
 447              */
 448             if (!chainConstraints->fPathLenConstraint ||
 449              constraints.dwPathLenConstraint <
 450              chainConstraints->dwPathLenConstraint)
 451             {
 452                 TRACE_(chain)("setting path length constraint to %d\n",
 453                  chainConstraints->dwPathLenConstraint);
 454                 chainConstraints->fPathLenConstraint = TRUE;
 455                 chainConstraints->dwPathLenConstraint =
 456                  constraints.dwPathLenConstraint;
 457             }
 458         }
 459     }
 460     if (chainConstraints->fPathLenConstraint &&
 461      remainingCAs > chainConstraints->dwPathLenConstraint)
 462     {
 463         TRACE_(chain)("remaining CAs %d exceed max path length %d\n",
 464          remainingCAs, chainConstraints->dwPathLenConstraint);
 465         validBasicConstraints = FALSE;
 466         *pathLengthConstraintViolated = TRUE;
 467     }
 468     return validBasicConstraints;
 469 }
 470
 471 static BOOL url_matches(LPCWSTR constraint, LPCWSTR name,
 472  DWORD *trustErrorStatus)
 473 {
 474     BOOL match = FALSE;
 475
 476     TRACE("%s, %s\n", debugstr_w(constraint), debugstr_w(name));
 477
 478     if (!constraint)
 479         *trustErrorStatus |= CERT_TRUST_INVALID_NAME_CONSTRAINTS;
 480     else if (!name)
 481         ; /* no match */
 482     else if (constraint[0] == '.')
 483     {
 484         if (lstrlenW(name) > lstrlenW(constraint))
 485             match = !lstrcmpiW(name + lstrlenW(name) - lstrlenW(constraint),
 486              constraint);
 487     }
 488     else
 489         match = !lstrcmpiW(constraint, name);
 490     return match;
 491 }
 492
 493 static BOOL rfc822_name_matches(LPCWSTR constraint, LPCWSTR name,
 494  DWORD *trustErrorStatus)
 495 {
 496     BOOL match = FALSE;
 497     LPCWSTR at;
 498
 499     TRACE("%s, %s\n", debugstr_w(constraint), debugstr_w(name));
 500
 501     if (!constraint)
 502         *trustErrorStatus |= CERT_TRUST_INVALID_NAME_CONSTRAINTS;
 503     else if (!name)
 504         ; /* no match */
 505     else if ((at = strchrW(constraint, '@')))
 506         match = !lstrcmpiW(constraint, name);
 507     else
 508     {
 509         if ((at = strchrW(name, '@')))
 510             match = url_matches(constraint, at + 1, trustErrorStatus);
 511         else
 512             match = !lstrcmpiW(constraint, name);
 513     }
 514     return match;
 515 }
 516
 517 static BOOL dns_name_matches(LPCWSTR constraint, LPCWSTR name,
 518  DWORD *trustErrorStatus)
 519 {
 520     BOOL match = FALSE;
 521
 522     TRACE("%s, %s\n", debugstr_w(constraint), debugstr_w(name));
 523
 524     if (!constraint)
 525         *trustErrorStatus |= CERT_TRUST_INVALID_NAME_CONSTRAINTS;
 526     else if (!name)
 527         ; /* no match */
 528     else if (lstrlenW(name) >= lstrlenW(constraint))
 529         match = !lstrcmpiW(name + lstrlenW(name) - lstrlenW(constraint),
 530          constraint);
 531     /* else:  name is too short, no match */
 532
 533     return match;
 534 }
 535
 536 static BOOL ip_address_matches(const CRYPT_DATA_BLOB *constraint,
 537  const CRYPT_DATA_BLOB *name, DWORD *trustErrorStatus)
 538 {
 539     BOOL match = FALSE;
 540
 541     TRACE("(%d, %p), (%d, %p)\n", constraint->cbData, constraint->pbData,
 542      name->cbData, name->pbData);
 543
 544     if (constraint->cbData != sizeof(DWORD) * 2)
 545         *trustErrorStatus |= CERT_TRUST_INVALID_NAME_CONSTRAINTS;
 546     else if (name->cbData == sizeof(DWORD))
 547     {
 548         DWORD subnet, mask, addr;
 549
 550         memcpy(&subnet, constraint->pbData, sizeof(subnet));
 551         memcpy(&mask, constraint->pbData + sizeof(subnet), sizeof(mask));
 552         memcpy(&addr, name->pbData, sizeof(addr));
 553         /* These are really in big-endian order, but for equality matching we
 554          * don't need to swap to host order
 555          */
 556         match = (subnet & mask) == (addr & mask);
 557     }
 558     /* else: name is wrong size, no match */
 559
 560     return match;
 561 }
 562
 563 static void CRYPT_FindMatchingNameEntry(const CERT_ALT_NAME_ENTRY *constraint,
 564  const CERT_ALT_NAME_INFO *subjectName, DWORD *trustErrorStatus,
 565  DWORD errorIfFound, DWORD errorIfNotFound)
 566 {
 567     DWORD i;
 568     BOOL match = FALSE;
 569
 570     for (i = 0; i < subjectName->cAltEntry; i++)
 571     {
 572         if (subjectName->rgAltEntry[i].dwAltNameChoice ==
 573          constraint->dwAltNameChoice)
 574         {
 575             switch (constraint->dwAltNameChoice)
 576             {
 577             case CERT_ALT_NAME_RFC822_NAME:
 578                 match = rfc822_name_matches(constraint->u.pwszURL,
 579                  subjectName->rgAltEntry[i].u.pwszURL, trustErrorStatus);
 580                 break;
 581             case CERT_ALT_NAME_DNS_NAME:
 582                 match = dns_name_matches(constraint->u.pwszURL,
 583                  subjectName->rgAltEntry[i].u.pwszURL, trustErrorStatus);
 584                 break;
 585             case CERT_ALT_NAME_URL:
 586                 match = url_matches(constraint->u.pwszURL,
 587                  subjectName->rgAltEntry[i].u.pwszURL, trustErrorStatus);
 588                 break;
 589             case CERT_ALT_NAME_IP_ADDRESS:
 590                 match = ip_address_matches(&constraint->u.IPAddress,
 591                  &subjectName->rgAltEntry[i].u.IPAddress, trustErrorStatus);
 592                 break;
 593             case CERT_ALT_NAME_DIRECTORY_NAME:
 594             default:
 595                 ERR("name choice %d unsupported in this context\n",
 596                  constraint->dwAltNameChoice);
 597                 *trustErrorStatus |=
 598                  CERT_TRUST_HAS_NOT_SUPPORTED_NAME_CONSTRAINT;
 599             }
 600         }
 601     }
 602     *trustErrorStatus |= match ? errorIfFound : errorIfNotFound;
 603 }
 604
 605 static void CRYPT_CheckNameConstraints(
 606  const CERT_NAME_CONSTRAINTS_INFO *nameConstraints, const CERT_INFO *cert,
 607  DWORD *trustErrorStatus)
 608 {
 609     /* If there aren't any existing constraints, don't bother checking */
 610     if (nameConstraints->cPermittedSubtree || nameConstraints->cExcludedSubtree)
 611     {
 612         CERT_EXTENSION *ext;
 613
 614         if ((ext = CertFindExtension(szOID_SUBJECT_ALT_NAME, cert->cExtension,
 615          cert->rgExtension)))
 616         {
 617             CERT_ALT_NAME_INFO *subjectName;
 618             DWORD size;
 619
 620             if (CryptDecodeObjectEx(X509_ASN_ENCODING, X509_ALTERNATE_NAME,
 621              ext->Value.pbData, ext->Value.cbData,
 622              CRYPT_DECODE_ALLOC_FLAG | CRYPT_DECODE_NOCOPY_FLAG, NULL,
 623              &subjectName, &size))
 624             {
 625                 DWORD i;
 626
 627                 for (i = 0; i < nameConstraints->cExcludedSubtree; i++)
 628                     CRYPT_FindMatchingNameEntry(
 629                      &nameConstraints->rgExcludedSubtree[i].Base, subjectName,
 630                      trustErrorStatus,
 631                      CERT_TRUST_HAS_EXCLUDED_NAME_CONSTRAINT, 0);
 632                 for (i = 0; i < nameConstraints->cPermittedSubtree; i++)
 633                     CRYPT_FindMatchingNameEntry(
 634                      &nameConstraints->rgPermittedSubtree[i].Base, subjectName,
 635                      trustErrorStatus,
 636                      0, CERT_TRUST_HAS_NOT_PERMITTED_NAME_CONSTRAINT);
 637                 LocalFree(subjectName);
 638             }
 639         }
 640         else
 641         {
 642             if (nameConstraints->cPermittedSubtree)
 643                 *trustErrorStatus |=
 644                  CERT_TRUST_HAS_NOT_PERMITTED_NAME_CONSTRAINT;
 645             if (nameConstraints->cExcludedSubtree)
 646                 *trustErrorStatus |=
 647                  CERT_TRUST_HAS_EXCLUDED_NAME_CONSTRAINT;
 648         }
 649     }
 650 }
 651
 652 /* Gets cert's name constraints, if any.  Free with LocalFree. */
 653 static CERT_NAME_CONSTRAINTS_INFO *CRYPT_GetNameConstraints(CERT_INFO *cert)
 654 {
 655     CERT_NAME_CONSTRAINTS_INFO *info = NULL;
 656
 657     CERT_EXTENSION *ext;
 658
 659     if ((ext = CertFindExtension(szOID_NAME_CONSTRAINTS, cert->cExtension,
 660      cert->rgExtension)))
 661     {
 662         DWORD size;
 663
 664         CryptDecodeObjectEx(X509_ASN_ENCODING, X509_NAME_CONSTRAINTS,
 665          ext->Value.pbData, ext->Value.cbData,
 666          CRYPT_DECODE_ALLOC_FLAG | CRYPT_DECODE_NOCOPY_FLAG, NULL, &info,
 667          &size);
 668     }
 669     return info;
 670 }
 671
 672 static void CRYPT_CheckChainNameConstraints(PCERT_SIMPLE_CHAIN chain)
 673 {
 674     int i, j;
 675
 676     /* Microsoft's implementation appears to violate RFC 3280:  according to
 677      * MSDN, the various CERT_TRUST_*_NAME_CONSTRAINT errors are set if a CA's
 678      * name constraint is violated in the end cert.  According to RFC 3280,
 679      * the constraints should be checked against every subsequent certificate
 680      * in the chain, not just the end cert.
 681      * Microsoft's implementation also sets the name constraint errors on the
 682      * certs whose constraints were violated, not on the certs that violated
 683      * them.
 684      * In order to be error-compatible with Microsoft's implementation, while
 685      * still adhering to RFC 3280, I use a O(n ^ 2) algorithm to check name
 686      * constraints.
 687      */
 688     for (i = chain->cElement - 1; i > 0; i--)
 689     {
 690         CERT_NAME_CONSTRAINTS_INFO *nameConstraints;
 691
 692         if ((nameConstraints = CRYPT_GetNameConstraints(
 693          chain->rgpElement[i]->pCertContext->pCertInfo)))
 694         {
 695             for (j = i - 1; j >= 0; j--)
 696             {
 697                 DWORD errorStatus = 0;
 698
 699                 /* According to RFC 3280, self-signed certs don't have name
 700                  * constraints checked unless they're the end cert.
 701                  */
 702                 if (j == 0 || !CRYPT_IsCertificateSelfSigned(
 703                  chain->rgpElement[j]->pCertContext))
 704                 {
 705                     CRYPT_CheckNameConstraints(nameConstraints,
 706                      chain->rgpElement[i]->pCertContext->pCertInfo,
 707                      &errorStatus);
 708                     chain->rgpElement[i]->TrustStatus.dwErrorStatus |=
 709                      errorStatus;
 710                 }
 711             }
 712             LocalFree(nameConstraints);
 713         }
 714     }
 715 }
 716
 717 static void dump_basic_constraints(PCERT_EXTENSION ext)
 718 {
 719     CERT_BASIC_CONSTRAINTS_INFO *info;
 720     DWORD size = 0;
 721
 722     if (CryptDecodeObjectEx(X509_ASN_ENCODING, szOID_BASIC_CONSTRAINTS,
 723      ext->Value.pbData, ext->Value.cbData, CRYPT_DECODE_ALLOC_FLAG,
 724      NULL, &info, &size))
 725     {
 726         TRACE_(chain)("SubjectType: %02x\n", info->SubjectType.pbData[0]);
 727         TRACE_(chain)("%s path length constraint\n",
 728          info->fPathLenConstraint ? "has" : "doesn't have");
 729         TRACE_(chain)("path length=%d\n", info->dwPathLenConstraint);
 730         LocalFree(info);
 731     }
 732 }
 733
 734 static void dump_basic_constraints2(PCERT_EXTENSION ext)
 735 {
 736     CERT_BASIC_CONSTRAINTS2_INFO constraints;
 737     DWORD size = sizeof(CERT_BASIC_CONSTRAINTS2_INFO);
 738
 739     if (CryptDecodeObjectEx(X509_ASN_ENCODING,
 740      szOID_BASIC_CONSTRAINTS2, ext->Value.pbData, ext->Value.cbData,
 741      0, NULL, &constraints, &size))
 742     {
 743         TRACE_(chain)("basic constraints:\n");
 744         TRACE_(chain)("can%s be a CA\n", constraints.fCA ? "" : "not");
 745         TRACE_(chain)("%s path length constraint\n",
 746          constraints.fPathLenConstraint ? "has" : "doesn't have");
 747         TRACE_(chain)("path length=%d\n", constraints.dwPathLenConstraint);
 748     }
 749 }
 750
 751 static void dump_extension(PCERT_EXTENSION ext)
 752 {
 753     TRACE_(chain)("%s (%scritical)\n", debugstr_a(ext->pszObjId),
 754      ext->fCritical ? "" : "not ");
 755     if (!strcmp(ext->pszObjId, szOID_BASIC_CONSTRAINTS))
 756         dump_basic_constraints(ext);
 757     else if (!strcmp(ext->pszObjId, szOID_BASIC_CONSTRAINTS2))
 758         dump_basic_constraints2(ext);
 759 }
 760
 761 static LPCWSTR filetime_to_str(const FILETIME *time)
 762 {
 763     static WCHAR date[80];
 764     WCHAR dateFmt[80]; /* sufficient for all versions of LOCALE_SSHORTDATE */
 765     SYSTEMTIME sysTime;
 766
 767     if (!time) return NULL;
 768
 769     GetLocaleInfoW(LOCALE_SYSTEM_DEFAULT, LOCALE_SSHORTDATE, dateFmt,
 770      sizeof(dateFmt) / sizeof(dateFmt[0]));
 771     FileTimeToSystemTime(time, &sysTime);
 772     GetDateFormatW(LOCALE_SYSTEM_DEFAULT, 0, &sysTime, dateFmt, date,
 773      sizeof(date) / sizeof(date[0]));
 774     return date;
 775 }
 776
 777 static void dump_element(PCCERT_CONTEXT cert)
 778 {
 779     LPWSTR name = NULL;
 780     DWORD len, i;
 781
 782     TRACE_(chain)("%p\n", cert);
 783     len = CertGetNameStringW(cert, CERT_NAME_SIMPLE_DISPLAY_TYPE,
 784      CERT_NAME_ISSUER_FLAG, NULL, NULL, 0);
 785     name = CryptMemAlloc(len * sizeof(WCHAR));
 786     if (name)
 787     {
 788         CertGetNameStringW(cert, CERT_NAME_SIMPLE_DISPLAY_TYPE,
 789          CERT_NAME_ISSUER_FLAG, NULL, name, len);
 790         TRACE_(chain)("issued by %s\n", debugstr_w(name));
 791         CryptMemFree(name);
 792     }
 793     len = CertGetNameStringW(cert, CERT_NAME_SIMPLE_DISPLAY_TYPE, 0, NULL,
 794      NULL, 0);
 795     name = CryptMemAlloc(len * sizeof(WCHAR));
 796     if (name)
 797     {
 798         CertGetNameStringW(cert, CERT_NAME_SIMPLE_DISPLAY_TYPE, 0, NULL,
 799          name, len);
 800         TRACE_(chain)("issued to %s\n", debugstr_w(name));
 801         CryptMemFree(name);
 802     }
 803     TRACE_(chain)("valid from %s",
 804      debugstr_w(filetime_to_str(&cert->pCertInfo->NotBefore)));
 805     TRACE_(chain)("to %s\n",
 806      debugstr_w(filetime_to_str(&cert->pCertInfo->NotAfter)));
 807     TRACE_(chain)("%d extensions\n", cert->pCertInfo->cExtension);
 808     for (i = 0; i < cert->pCertInfo->cExtension; i++)
 809         dump_extension(&cert->pCertInfo->rgExtension[i]);
 810 }
 811
 812 static void CRYPT_CheckSimpleChain(PCertificateChainEngine engine,
 813  PCERT_SIMPLE_CHAIN chain, LPFILETIME time)
 814 {
 815     PCERT_CHAIN_ELEMENT rootElement = chain->rgpElement[chain->cElement - 1];
 816     int i;
 817     BOOL pathLengthConstraintViolated = FALSE;
 818     CERT_BASIC_CONSTRAINTS2_INFO constraints = { TRUE, FALSE, 0 };
 819
 820     TRACE_(chain)("checking chain with %d elements for time %s\n",
 821      chain->cElement, debugstr_w(filetime_to_str(time)));
 822     for (i = chain->cElement - 1; i >= 0; i--)
 823     {
 824         if (TRACE_ON(chain))
 825             dump_element(chain->rgpElement[i]->pCertContext);
 826         if (CertVerifyTimeValidity(time,
 827          chain->rgpElement[i]->pCertContext->pCertInfo) != 0)
 828             chain->rgpElement[i]->TrustStatus.dwErrorStatus |=
 829              CERT_TRUST_IS_NOT_TIME_VALID;
 830         if (i != 0)
 831         {
 832             BOOL isRoot;
 833
 834             if (i == chain->cElement - 1)
 835                 isRoot = CRYPT_IsCertificateSelfSigned(
 836                  chain->rgpElement[i]->pCertContext);
 837             else
 838                 isRoot = FALSE;
 839             /* Check the signature of the cert this issued */
 840             if (!CryptVerifyCertificateSignatureEx(0, X509_ASN_ENCODING,
 841              CRYPT_VERIFY_CERT_SIGN_SUBJECT_CERT,
 842              (void *)chain->rgpElement[i - 1]->pCertContext,
 843              CRYPT_VERIFY_CERT_SIGN_ISSUER_CERT,
 844              (void *)chain->rgpElement[i]->pCertContext, 0, NULL))
 845                 chain->rgpElement[i - 1]->TrustStatus.dwErrorStatus |=
 846                  CERT_TRUST_IS_NOT_SIGNATURE_VALID;
 847             /* Once a path length constraint has been violated, every remaining
 848              * CA cert's basic constraints is considered invalid.
 849              */
 850             if (pathLengthConstraintViolated)
 851                 chain->rgpElement[i]->TrustStatus.dwErrorStatus |=
 852                  CERT_TRUST_INVALID_BASIC_CONSTRAINTS;
 853             else if (!CRYPT_CheckBasicConstraintsForCA(
 854              chain->rgpElement[i]->pCertContext, &constraints, i - 1,
 855              isRoot, &pathLengthConstraintViolated))
 856                 chain->rgpElement[i]->TrustStatus.dwErrorStatus |=
 857                  CERT_TRUST_INVALID_BASIC_CONSTRAINTS;
 858             else if (constraints.fPathLenConstraint &&
 859              constraints.dwPathLenConstraint)
 860             {
 861                 /* This one's valid - decrement max length */
 862                 constraints.dwPathLenConstraint--;
 863             }
 864         }
 865         if (CRYPT_IsSimpleChainCyclic(chain))
 866         {
 867             /* If the chain is cyclic, then the path length constraints
 868              * are violated, because the chain is infinitely long.
 869              */
 870             pathLengthConstraintViolated = TRUE;
 871             chain->TrustStatus.dwErrorStatus |=
 872              CERT_TRUST_IS_PARTIAL_CHAIN |
 873              CERT_TRUST_INVALID_BASIC_CONSTRAINTS;
 874         }
 875         /* FIXME: check valid usages */
 876         CRYPT_CombineTrustStatus(&chain->TrustStatus,
 877          &chain->rgpElement[i]->TrustStatus);
 878     }
 879     CRYPT_CheckChainNameConstraints(chain);
 880     if (CRYPT_IsCertificateSelfSigned(rootElement->pCertContext))
 881     {
 882         rootElement->TrustStatus.dwInfoStatus |=
 883          CERT_TRUST_IS_SELF_SIGNED | CERT_TRUST_HAS_NAME_MATCH_ISSUER;
 884         CRYPT_CheckRootCert(engine->hRoot, rootElement);
 885     }
 886     CRYPT_CombineTrustStatus(&chain->TrustStatus, &rootElement->TrustStatus);
 887 }
 888
 889 static PCCERT_CONTEXT CRYPT_GetIssuer(HCERTSTORE store, PCCERT_CONTEXT subject,
 890  PCCERT_CONTEXT prevIssuer, DWORD *infoStatus)
 891 {
 892     PCCERT_CONTEXT issuer = NULL;
 893     PCERT_EXTENSION ext;
 894     DWORD size;
 895
 896     *infoStatus = 0;
 897     if ((ext = CertFindExtension(szOID_AUTHORITY_KEY_IDENTIFIER,
 898      subject->pCertInfo->cExtension, subject->pCertInfo->rgExtension)))
 899     {
 900         CERT_AUTHORITY_KEY_ID_INFO *info;
 901         BOOL ret;
 902
 903         ret = CryptDecodeObjectEx(subject->dwCertEncodingType,
 904          X509_AUTHORITY_KEY_ID, ext->Value.pbData, ext->Value.cbData,
 905          CRYPT_DECODE_ALLOC_FLAG | CRYPT_DECODE_NOCOPY_FLAG, NULL,
 906          &info, &size);
 907         if (ret)
 908         {
 909             CERT_ID id;
 910
 911             if (info->CertIssuer.cbData && info->CertSerialNumber.cbData)
 912             {
 913                 id.dwIdChoice = CERT_ID_ISSUER_SERIAL_NUMBER;
 914                 memcpy(&id.u.IssuerSerialNumber.Issuer, &info->CertIssuer,
 915                  sizeof(CERT_NAME_BLOB));
 916                 memcpy(&id.u.IssuerSerialNumber.SerialNumber,
 917                  &info->CertSerialNumber, sizeof(CRYPT_INTEGER_BLOB));
 918                 issuer = CertFindCertificateInStore(store,
 919                  subject->dwCertEncodingType, 0, CERT_FIND_CERT_ID, &id,
 920                  prevIssuer);
 921                 if (issuer)
 922                     *infoStatus = CERT_TRUST_HAS_EXACT_MATCH_ISSUER;
 923             }
 924             else if (info->KeyId.cbData)
 925             {
 926                 id.dwIdChoice = CERT_ID_KEY_IDENTIFIER;
 927                 memcpy(&id.u.KeyId, &info->KeyId, sizeof(CRYPT_HASH_BLOB));
 928                 issuer = CertFindCertificateInStore(store,
 929                  subject->dwCertEncodingType, 0, CERT_FIND_CERT_ID, &id,
 930                  prevIssuer);
 931                 if (issuer)
 932                     *infoStatus = CERT_TRUST_HAS_KEY_MATCH_ISSUER;
 933             }
 934             LocalFree(info);
 935         }
 936     }
 937     else if ((ext = CertFindExtension(szOID_AUTHORITY_KEY_IDENTIFIER2,
 938      subject->pCertInfo->cExtension, subject->pCertInfo->rgExtension)))
 939     {
 940         CERT_AUTHORITY_KEY_ID2_INFO *info;
 941         BOOL ret;
 942
 943         ret = CryptDecodeObjectEx(subject->dwCertEncodingType,
 944          X509_AUTHORITY_KEY_ID2, ext->Value.pbData, ext->Value.cbData,
 945          CRYPT_DECODE_ALLOC_FLAG | CRYPT_DECODE_NOCOPY_FLAG, NULL,
 946          &info, &size);
 947         if (ret)
 948         {
 949             CERT_ID id;
 950
 951             if (info->AuthorityCertIssuer.cAltEntry &&
 952              info->AuthorityCertSerialNumber.cbData)
 953             {
 954                 PCERT_ALT_NAME_ENTRY directoryName = NULL;
 955                 DWORD i;
 956
 957                 for (i = 0; !directoryName &&
 958                  i < info->AuthorityCertIssuer.cAltEntry; i++)
 959                     if (info->AuthorityCertIssuer.rgAltEntry[i].dwAltNameChoice
 960                      == CERT_ALT_NAME_DIRECTORY_NAME)
 961                         directoryName =
 962                          &info->AuthorityCertIssuer.rgAltEntry[i];
 963                 if (directoryName)
 964                 {
 965                     id.dwIdChoice = CERT_ID_ISSUER_SERIAL_NUMBER;
 966                     memcpy(&id.u.IssuerSerialNumber.Issuer,
 967                      &directoryName->u.DirectoryName, sizeof(CERT_NAME_BLOB));
 968                     memcpy(&id.u.IssuerSerialNumber.SerialNumber,
 969                      &info->AuthorityCertSerialNumber,
 970                      sizeof(CRYPT_INTEGER_BLOB));
 971                     issuer = CertFindCertificateInStore(store,
 972                      subject->dwCertEncodingType, 0, CERT_FIND_CERT_ID, &id,
 973                      prevIssuer);
 974                     if (issuer)
 975                         *infoStatus = CERT_TRUST_HAS_EXACT_MATCH_ISSUER;
 976                 }
 977                 else
 978                     FIXME("no supported name type in authority key id2\n");
 979             }
 980             else if (info->KeyId.cbData)
 981             {
 982                 id.dwIdChoice = CERT_ID_KEY_IDENTIFIER;
 983                 memcpy(&id.u.KeyId, &info->KeyId, sizeof(CRYPT_HASH_BLOB));
 984                 issuer = CertFindCertificateInStore(store,
 985                  subject->dwCertEncodingType, 0, CERT_FIND_CERT_ID, &id,
 986                  prevIssuer);
 987                 if (issuer)
 988                     *infoStatus = CERT_TRUST_HAS_KEY_MATCH_ISSUER;
 989             }
 990             LocalFree(info);
 991         }
 992     }
 993     else
 994     {
 995         issuer = CertFindCertificateInStore(store,
 996          subject->dwCertEncodingType, 0, CERT_FIND_SUBJECT_NAME,
 997          &subject->pCertInfo->Issuer, prevIssuer);
 998         *infoStatus = CERT_TRUST_HAS_NAME_MATCH_ISSUER;
 999     }
1000     return issuer;
1001 }
1002
1003 /* Builds a simple chain by finding an issuer for the last cert in the chain,
1004  * until reaching a self-signed cert, or until no issuer can be found.
1005  */
1006 static BOOL CRYPT_BuildSimpleChain(PCertificateChainEngine engine,
1007  HCERTSTORE world, PCERT_SIMPLE_CHAIN chain)
1008 {
1009     BOOL ret = TRUE;
1010     PCCERT_CONTEXT cert = chain->rgpElement[chain->cElement - 1]->pCertContext;
1011
1012     while (ret && !CRYPT_IsSimpleChainCyclic(chain) &&
1013      !CRYPT_IsCertificateSelfSigned(cert))
1014     {
1015         PCCERT_CONTEXT issuer = CRYPT_GetIssuer(world, cert, NULL,
1016          &chain->rgpElement[chain->cElement - 1]->TrustStatus.dwInfoStatus);
1017
1018         if (issuer)
1019         {
1020             ret = CRYPT_AddCertToSimpleChain(engine, chain, issuer,
1021              chain->rgpElement[chain->cElement - 1]->TrustStatus.dwInfoStatus);
1022             /* CRYPT_AddCertToSimpleChain add-ref's the issuer, so free it to
1023              * close the enumeration that found it
1024              */
1025             CertFreeCertificateContext(issuer);
1026             cert = issuer;
1027         }
1028         else
1029         {
1030             TRACE_(chain)("Couldn't find issuer, halting chain creation\n");
1031             chain->TrustStatus.dwErrorStatus |= CERT_TRUST_IS_PARTIAL_CHAIN;
1032             break;
1033         }
1034     }
1035     return ret;
1036 }
1037
1038 static BOOL CRYPT_GetSimpleChainForCert(PCertificateChainEngine engine,
1039  HCERTSTORE world, PCCERT_CONTEXT cert, LPFILETIME pTime,
1040  PCERT_SIMPLE_CHAIN *ppChain)
1041 {
1042     BOOL ret = FALSE;
1043     PCERT_SIMPLE_CHAIN chain;
1044
1045     TRACE("(%p, %p, %p, %p)\n", engine, world, cert, pTime);
1046
1047     chain = CryptMemAlloc(sizeof(CERT_SIMPLE_CHAIN));
1048     if (chain)
1049     {
1050         memset(chain, 0, sizeof(CERT_SIMPLE_CHAIN));
1051         chain->cbSize = sizeof(CERT_SIMPLE_CHAIN);
1052         ret = CRYPT_AddCertToSimpleChain(engine, chain, cert, 0);
1053         if (ret)
1054         {
1055             ret = CRYPT_BuildSimpleChain(engine, world, chain);
1056             if (ret)
1057                 CRYPT_CheckSimpleChain(engine, chain, pTime);
1058         }
1059         if (!ret)
1060         {
1061             CRYPT_FreeSimpleChain(chain);
1062             chain = NULL;
1063         }
1064         *ppChain = chain;
1065     }
1066     return ret;
1067 }
1068
1069 static BOOL CRYPT_BuildCandidateChainFromCert(HCERTCHAINENGINE hChainEngine,
1070  PCCERT_CONTEXT cert, LPFILETIME pTime, HCERTSTORE hAdditionalStore,
1071  PCertificateChain *ppChain)
1072 {
1073     PCertificateChainEngine engine = (PCertificateChainEngine)hChainEngine;
1074     PCERT_SIMPLE_CHAIN simpleChain = NULL;
1075     HCERTSTORE world;
1076     BOOL ret;
1077
1078     world = CertOpenStore(CERT_STORE_PROV_COLLECTION, 0, 0,
1079      CERT_STORE_CREATE_NEW_FLAG, NULL);
1080     CertAddStoreToCollection(world, engine->hWorld, 0, 0);
1081     if (hAdditionalStore)
1082         CertAddStoreToCollection(world, hAdditionalStore, 0, 0);
1083     /* FIXME: only simple chains are supported for now, as CTLs aren't
1084      * supported yet.
1085      */
1086     if ((ret = CRYPT_GetSimpleChainForCert(engine, world, cert, pTime,
1087      &simpleChain)))
1088     {
1089         PCertificateChain chain = CryptMemAlloc(sizeof(CertificateChain));
1090
1091         if (chain)
1092         {
1093             chain->ref = 1;
1094             chain->world = world;
1095             chain->context.cbSize = sizeof(CERT_CHAIN_CONTEXT);
1096             chain->context.TrustStatus = simpleChain->TrustStatus;
1097             chain->context.cChain = 1;
1098             chain->context.rgpChain = CryptMemAlloc(sizeof(PCERT_SIMPLE_CHAIN));
1099             chain->context.rgpChain[0] = simpleChain;
1100             chain->context.cLowerQualityChainContext = 0;
1101             chain->context.rgpLowerQualityChainContext = NULL;
1102             chain->context.fHasRevocationFreshnessTime = FALSE;
1103             chain->context.dwRevocationFreshnessTime = 0;
1104         }
1105         else
1106             ret = FALSE;
1107         *ppChain = chain;
1108     }
1109     return ret;
1110 }
1111
1112 /* Makes and returns a copy of chain, up to and including element iElement. */
1113 static PCERT_SIMPLE_CHAIN CRYPT_CopySimpleChainToElement(
1114  PCERT_SIMPLE_CHAIN chain, DWORD iElement)
1115 {
1116     PCERT_SIMPLE_CHAIN copy = CryptMemAlloc(sizeof(CERT_SIMPLE_CHAIN));
1117
1118     if (copy)
1119     {
1120         memset(copy, 0, sizeof(CERT_SIMPLE_CHAIN));
1121         copy->cbSize = sizeof(CERT_SIMPLE_CHAIN);
1122         copy->rgpElement =
1123          CryptMemAlloc((iElement + 1) * sizeof(PCERT_CHAIN_ELEMENT));
1124         if (copy->rgpElement)
1125         {
1126             DWORD i;
1127             BOOL ret = TRUE;
1128
1129             memset(copy->rgpElement, 0,
1130              (iElement + 1) * sizeof(PCERT_CHAIN_ELEMENT));
1131             for (i = 0; ret && i <= iElement; i++)
1132             {
1133                 PCERT_CHAIN_ELEMENT element =
1134                  CryptMemAlloc(sizeof(CERT_CHAIN_ELEMENT));
1135
1136                 if (element)
1137                 {
1138                     *element = *chain->rgpElement[i];
1139                     element->pCertContext = CertDuplicateCertificateContext(
1140                      chain->rgpElement[i]->pCertContext);
1141                     /* Reset the trust status of the copied element, it'll get
1142                      * rechecked after the new chain is done.
1143                      */
1144                     memset(&element->TrustStatus, 0, sizeof(CERT_TRUST_STATUS));
1145                     copy->rgpElement[copy->cElement++] = element;
1146                 }
1147                 else
1148                     ret = FALSE;
1149             }
1150             if (!ret)
1151             {
1152                 for (i = 0; i <= iElement; i++)
1153                     CryptMemFree(copy->rgpElement[i]);
1154                 CryptMemFree(copy->rgpElement);
1155                 CryptMemFree(copy);
1156                 copy = NULL;
1157             }
1158         }
1159         else
1160         {
1161             CryptMemFree(copy);
1162             copy = NULL;
1163         }
1164     }
1165     return copy;
1166 }
1167
1168 static void CRYPT_FreeLowerQualityChains(PCertificateChain chain)
1169 {
1170     DWORD i;
1171
1172     for (i = 0; i < chain->context.cLowerQualityChainContext; i++)
1173         CertFreeCertificateChain(chain->context.rgpLowerQualityChainContext[i]);
1174     CryptMemFree(chain->context.rgpLowerQualityChainContext);
1175     chain->context.cLowerQualityChainContext = 0;
1176     chain->context.rgpLowerQualityChainContext = NULL;
1177 }
1178
1179 static void CRYPT_FreeChainContext(PCertificateChain chain)
1180 {
1181     DWORD i;
1182
1183     CRYPT_FreeLowerQualityChains(chain);
1184     for (i = 0; i < chain->context.cChain; i++)
1185         CRYPT_FreeSimpleChain(chain->context.rgpChain[i]);
1186     CryptMemFree(chain->context.rgpChain);
1187     CertCloseStore(chain->world, 0);
1188     CryptMemFree(chain);
1189 }
1190
1191 /* Makes and returns a copy of chain, up to and including element iElement of
1192  * simple chain iChain.
1193  */
1194 static PCertificateChain CRYPT_CopyChainToElement(PCertificateChain chain,
1195  DWORD iChain, DWORD iElement)
1196 {
1197     PCertificateChain copy = CryptMemAlloc(sizeof(CertificateChain));
1198
1199     if (copy)
1200     {
1201         copy->ref = 1;
1202         copy->world = CertDuplicateStore(chain->world);
1203         copy->context.cbSize = sizeof(CERT_CHAIN_CONTEXT);
1204         /* Leave the trust status of the copied chain unset, it'll get
1205          * rechecked after the new chain is done.
1206          */
1207         memset(&copy->context.TrustStatus, 0, sizeof(CERT_TRUST_STATUS));
1208         copy->context.cLowerQualityChainContext = 0;
1209         copy->context.rgpLowerQualityChainContext = NULL;
1210         copy->context.fHasRevocationFreshnessTime = FALSE;
1211         copy->context.dwRevocationFreshnessTime = 0;
1212         copy->context.rgpChain = CryptMemAlloc(
1213          (iChain + 1) * sizeof(PCERT_SIMPLE_CHAIN));
1214         if (copy->context.rgpChain)
1215         {
1216             BOOL ret = TRUE;
1217             DWORD i;
1218
1219             memset(copy->context.rgpChain, 0,
1220              (iChain + 1) * sizeof(PCERT_SIMPLE_CHAIN));
1221             if (iChain)
1222             {
1223                 for (i = 0; ret && iChain && i < iChain - 1; i++)
1224                 {
1225                     copy->context.rgpChain[i] =
1226                      CRYPT_CopySimpleChainToElement(chain->context.rgpChain[i],
1227                      chain->context.rgpChain[i]->cElement - 1);
1228                     if (!copy->context.rgpChain[i])
1229                         ret = FALSE;
1230                 }
1231             }
1232             else
1233                 i = 0;
1234             if (ret)
1235             {
1236                 copy->context.rgpChain[i] =
1237                  CRYPT_CopySimpleChainToElement(chain->context.rgpChain[i],
1238                  iElement);
1239                 if (!copy->context.rgpChain[i])
1240                     ret = FALSE;
1241             }
1242             if (!ret)
1243             {
1244                 CRYPT_FreeChainContext(copy);
1245                 copy = NULL;
1246             }
1247             else
1248                 copy->context.cChain = iChain + 1;
1249         }
1250         else
1251         {
1252             CryptMemFree(copy);
1253             copy = NULL;
1254         }
1255     }
1256     return copy;
1257 }
1258
1259 static PCertificateChain CRYPT_BuildAlternateContextFromChain(
1260  HCERTCHAINENGINE hChainEngine, LPFILETIME pTime, HCERTSTORE hAdditionalStore,
1261  PCertificateChain chain)
1262 {
1263     PCertificateChainEngine engine = (PCertificateChainEngine)hChainEngine;
1264     PCertificateChain alternate;
1265
1266     TRACE("(%p, %p, %p, %p)\n", hChainEngine, pTime, hAdditionalStore, chain);
1267
1268     /* Always start with the last "lower quality" chain to ensure a consistent
1269      * order of alternate creation:
1270      */
1271     if (chain->context.cLowerQualityChainContext)
1272         chain = (PCertificateChain)chain->context.rgpLowerQualityChainContext[
1273          chain->context.cLowerQualityChainContext - 1];
1274     /* A chain with only one element can't have any alternates */
1275     if (chain->context.cChain <= 1 && chain->context.rgpChain[0]->cElement <= 1)
1276         alternate = NULL;
1277     else
1278     {
1279         DWORD i, j, infoStatus;
1280         PCCERT_CONTEXT alternateIssuer = NULL;
1281
1282         alternate = NULL;
1283         for (i = 0; !alternateIssuer && i < chain->context.cChain; i++)
1284             for (j = 0; !alternateIssuer &&
1285              j < chain->context.rgpChain[i]->cElement - 1; j++)
1286             {
1287                 PCCERT_CONTEXT subject =
1288                  chain->context.rgpChain[i]->rgpElement[j]->pCertContext;
1289                 PCCERT_CONTEXT prevIssuer = CertDuplicateCertificateContext(
1290                  chain->context.rgpChain[i]->rgpElement[j + 1]->pCertContext);
1291
1292                 alternateIssuer = CRYPT_GetIssuer(prevIssuer->hCertStore,
1293                  subject, prevIssuer, &infoStatus);
1294             }
1295         if (alternateIssuer)
1296         {
1297             i--;
1298             j--;
1299             alternate = CRYPT_CopyChainToElement(chain, i, j);
1300             if (alternate)
1301             {
1302                 BOOL ret = CRYPT_AddCertToSimpleChain(engine,
1303                  alternate->context.rgpChain[i], alternateIssuer, infoStatus);
1304
1305                 /* CRYPT_AddCertToSimpleChain add-ref's the issuer, so free it
1306                  * to close the enumeration that found it
1307                  */
1308                 CertFreeCertificateContext(alternateIssuer);
1309                 if (ret)
1310                 {
1311                     ret = CRYPT_BuildSimpleChain(engine, alternate->world,
1312                      alternate->context.rgpChain[i]);
1313                     if (ret)
1314                         CRYPT_CheckSimpleChain(engine,
1315                          alternate->context.rgpChain[i], pTime);
1316                     CRYPT_CombineTrustStatus(&alternate->context.TrustStatus,
1317                      &alternate->context.rgpChain[i]->TrustStatus);
1318                 }
1319                 if (!ret)
1320                 {
1321                     CRYPT_FreeChainContext(alternate);
1322                     alternate = NULL;
1323                 }
1324             }
1325         }
1326     }
1327     TRACE("%p\n", alternate);
1328     return alternate;
1329 }
1330
1331 #define CHAIN_QUALITY_SIGNATURE_VALID 8
1332 #define CHAIN_QUALITY_TIME_VALID      4
1333 #define CHAIN_QUALITY_COMPLETE_CHAIN  2
1334 #define CHAIN_QUALITY_TRUSTED_ROOT    1
1335
1336 #define CHAIN_QUALITY_HIGHEST \
1337  CHAIN_QUALITY_SIGNATURE_VALID | CHAIN_QUALITY_TIME_VALID | \
1338  CHAIN_QUALITY_COMPLETE_CHAIN | CHAIN_QUALITY_TRUSTED_ROOT
1339
1340 #define IS_TRUST_ERROR_SET(TrustStatus, bits) \
1341  (TrustStatus)->dwErrorStatus & (bits)
1342
1343 static DWORD CRYPT_ChainQuality(PCertificateChain chain)
1344 {
1345     DWORD quality = CHAIN_QUALITY_HIGHEST;
1346
1347     if (IS_TRUST_ERROR_SET(&chain->context.TrustStatus,
1348      CERT_TRUST_IS_UNTRUSTED_ROOT))
1349         quality &= ~CHAIN_QUALITY_TRUSTED_ROOT;
1350     if (IS_TRUST_ERROR_SET(&chain->context.TrustStatus,
1351      CERT_TRUST_IS_PARTIAL_CHAIN))
1352     if (chain->context.TrustStatus.dwErrorStatus & CERT_TRUST_IS_PARTIAL_CHAIN)
1353         quality &= ~CHAIN_QUALITY_COMPLETE_CHAIN;
1354     if (IS_TRUST_ERROR_SET(&chain->context.TrustStatus,
1355      CERT_TRUST_IS_NOT_TIME_VALID | CERT_TRUST_IS_NOT_TIME_NESTED))
1356         quality &= ~CHAIN_QUALITY_TIME_VALID;
1357     if (IS_TRUST_ERROR_SET(&chain->context.TrustStatus,
1358      CERT_TRUST_IS_NOT_SIGNATURE_VALID))
1359         quality &= ~CHAIN_QUALITY_SIGNATURE_VALID;
1360     return quality;
1361 }
1362
1363 /* Chooses the highest quality chain among chain and its "lower quality"
1364  * alternate chains.  Returns the highest quality chain, with all other
1365  * chains as lower quality chains of it.
1366  */
1367 static PCertificateChain CRYPT_ChooseHighestQualityChain(
1368  PCertificateChain chain)
1369 {
1370     DWORD i;
1371
1372     /* There are always only two chains being considered:  chain, and an
1373      * alternate at chain->rgpLowerQualityChainContext[i].  If the alternate
1374      * has a higher quality than chain, the alternate gets assigned the lower
1375      * quality contexts, with chain taking the alternate's place among the
1376      * lower quality contexts.
1377      */
1378     for (i = 0; i < chain->context.cLowerQualityChainContext; i++)
1379     {
1380         PCertificateChain alternate =
1381          (PCertificateChain)chain->context.rgpLowerQualityChainContext[i];
1382
1383         if (CRYPT_ChainQuality(alternate) > CRYPT_ChainQuality(chain))
1384         {
1385             alternate->context.cLowerQualityChainContext =
1386              chain->context.cLowerQualityChainContext;
1387             alternate->context.rgpLowerQualityChainContext =
1388              chain->context.rgpLowerQualityChainContext;
1389             alternate->context.rgpLowerQualityChainContext[i] =
1390              (PCCERT_CHAIN_CONTEXT)chain;
1391             chain->context.cLowerQualityChainContext = 0;
1392             chain->context.rgpLowerQualityChainContext = NULL;
1393             chain = alternate;
1394         }
1395     }
1396     return chain;
1397 }
1398
1399 static BOOL CRYPT_AddAlternateChainToChain(PCertificateChain chain,
1400  PCertificateChain alternate)
1401 {
1402     BOOL ret;
1403
1404     if (chain->context.cLowerQualityChainContext)
1405         chain->context.rgpLowerQualityChainContext =
1406          CryptMemRealloc(chain->context.rgpLowerQualityChainContext,
1407          (chain->context.cLowerQualityChainContext + 1) *
1408          sizeof(PCCERT_CHAIN_CONTEXT));
1409     else
1410         chain->context.rgpLowerQualityChainContext =
1411          CryptMemAlloc(sizeof(PCCERT_CHAIN_CONTEXT));
1412     if (chain->context.rgpLowerQualityChainContext)
1413     {
1414         chain->context.rgpLowerQualityChainContext[
1415          chain->context.cLowerQualityChainContext++] =
1416          (PCCERT_CHAIN_CONTEXT)alternate;
1417         ret = TRUE;
1418     }
1419     else
1420         ret = FALSE;
1421     return ret;
1422 }
1423
1424 static PCERT_CHAIN_ELEMENT CRYPT_FindIthElementInChain(
1425  PCERT_CHAIN_CONTEXT chain, DWORD i)
1426 {
1427     DWORD j, iElement;
1428     PCERT_CHAIN_ELEMENT element = NULL;
1429
1430     for (j = 0, iElement = 0; !element && j < chain->cChain; j++)
1431     {
1432         if (iElement + chain->rgpChain[j]->cElement < i)
1433             iElement += chain->rgpChain[j]->cElement;
1434         else
1435             element = chain->rgpChain[j]->rgpElement[i - iElement];
1436     }
1437     return element;
1438 }
1439
1440 typedef struct _CERT_CHAIN_PARA_NO_EXTRA_FIELDS {
1441     DWORD            cbSize;
1442     CERT_USAGE_MATCH RequestedUsage;
1443 } CERT_CHAIN_PARA_NO_EXTRA_FIELDS, *PCERT_CHAIN_PARA_NO_EXTRA_FIELDS;
1444
1445 static void CRYPT_VerifyChainRevocation(PCERT_CHAIN_CONTEXT chain,
1446  LPFILETIME pTime, PCERT_CHAIN_PARA pChainPara, DWORD chainFlags)
1447 {
1448     DWORD cContext;
1449
1450     if (chainFlags & CERT_CHAIN_REVOCATION_CHECK_END_CERT)
1451         cContext = 1;
1452     else if ((chainFlags & CERT_CHAIN_REVOCATION_CHECK_CHAIN) ||
1453      (chainFlags & CERT_CHAIN_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT))
1454     {
1455         DWORD i;
1456
1457         for (i = 0, cContext = 0; i < chain->cChain; i++)
1458         {
1459             if (i < chain->cChain - 1 ||
1460              chainFlags & CERT_CHAIN_REVOCATION_CHECK_CHAIN)
1461                 cContext += chain->rgpChain[i]->cElement;
1462             else
1463                 cContext += chain->rgpChain[i]->cElement - 1;
1464         }
1465     }
1466     else
1467         cContext = 0;
1468     if (cContext)
1469     {
1470         PCCERT_CONTEXT *contexts =
1471          CryptMemAlloc(cContext * sizeof(PCCERT_CONTEXT *));
1472
1473         if (contexts)
1474         {
1475             DWORD i, j, iContext, revocationFlags;
1476             CERT_REVOCATION_PARA revocationPara = { sizeof(revocationPara), 0 };
1477             CERT_REVOCATION_STATUS revocationStatus =
1478              { sizeof(revocationStatus), 0 };
1479             BOOL ret;
1480
1481             for (i = 0, iContext = 0; iContext < cContext && i < chain->cChain;
1482              i++)
1483             {
1484                 for (j = 0; iContext < cContext &&
1485                  j < chain->rgpChain[i]->cElement; j++)
1486                     contexts[iContext++] =
1487                      chain->rgpChain[i]->rgpElement[j]->pCertContext;
1488             }
1489             revocationFlags = CERT_VERIFY_REV_CHAIN_FLAG;
1490             if (chainFlags & CERT_CHAIN_REVOCATION_CHECK_CACHE_ONLY)
1491                 revocationFlags |= CERT_VERIFY_CACHE_ONLY_BASED_REVOCATION;
1492             if (chainFlags & CERT_CHAIN_REVOCATION_ACCUMULATIVE_TIMEOUT)
1493                 revocationFlags |= CERT_VERIFY_REV_ACCUMULATIVE_TIMEOUT_FLAG;
1494             revocationPara.pftTimeToUse = pTime;
1495             if (pChainPara->cbSize == sizeof(CERT_CHAIN_PARA))
1496             {
1497                 revocationPara.dwUrlRetrievalTimeout =
1498                  pChainPara->dwUrlRetrievalTimeout;
1499                 revocationPara.fCheckFreshnessTime =
1500                  pChainPara->fCheckRevocationFreshnessTime;
1501                 revocationPara.dwFreshnessTime =
1502                  pChainPara->dwRevocationFreshnessTime;
1503             }
1504             ret = CertVerifyRevocation(X509_ASN_ENCODING,
1505              CERT_CONTEXT_REVOCATION_TYPE, cContext, (void **)contexts,
1506              revocationFlags, &revocationPara, &revocationStatus);
1507             if (!ret)
1508             {
1509                 PCERT_CHAIN_ELEMENT element =
1510                  CRYPT_FindIthElementInChain(chain, revocationStatus.dwIndex);
1511                 DWORD error;
1512
1513                 switch (revocationStatus.dwError)
1514                 {
1515                 case CRYPT_E_NO_REVOCATION_CHECK:
1516                 case CRYPT_E_NO_REVOCATION_DLL:
1517                 case CRYPT_E_NOT_IN_REVOCATION_DATABASE:
1518                     error = CERT_TRUST_REVOCATION_STATUS_UNKNOWN;
1519                     break;
1520                 case CRYPT_E_REVOCATION_OFFLINE:
1521                     error = CERT_TRUST_IS_OFFLINE_REVOCATION;
1522                     break;
1523                 case CRYPT_E_REVOKED:
1524                     error = CERT_TRUST_IS_REVOKED;
1525                     break;
1526                 default:
1527                     WARN("unmapped error %08x\n", revocationStatus.dwError);
1528                     error = 0;
1529                 }
1530                 if (element)
1531                 {
1532                     /* FIXME: set element's pRevocationInfo member */
1533                     element->TrustStatus.dwErrorStatus |= error;
1534                 }
1535                 chain->TrustStatus.dwErrorStatus |= error;
1536             }
1537             CryptMemFree(contexts);
1538         }
1539     }
1540 }
1541
1542 BOOL WINAPI CertGetCertificateChain(HCERTCHAINENGINE hChainEngine,
1543  PCCERT_CONTEXT pCertContext, LPFILETIME pTime, HCERTSTORE hAdditionalStore,
1544  PCERT_CHAIN_PARA pChainPara, DWORD dwFlags, LPVOID pvReserved,
1545  PCCERT_CHAIN_CONTEXT* ppChainContext)
1546 {
1547     BOOL ret;
1548     PCertificateChain chain = NULL;
1549
1550     TRACE("(%p, %p, %p, %p, %p, %08x, %p, %p)\n", hChainEngine, pCertContext,
1551      pTime, hAdditionalStore, pChainPara, dwFlags, pvReserved, ppChainContext);
1552
1553     if (ppChainContext)
1554         *ppChainContext = NULL;
1555     if (!pChainPara)
1556     {
1557         SetLastError(E_INVALIDARG);
1558         return FALSE;
1559     }
1560     if (!pCertContext->pCertInfo->SignatureAlgorithm.pszObjId)
1561     {
1562         SetLastError(ERROR_INVALID_DATA);
1563         return FALSE;
1564     }
1565     if (pChainPara->cbSize != sizeof(CERT_CHAIN_PARA_NO_EXTRA_FIELDS) &&
1566      pChainPara->cbSize != sizeof(CERT_CHAIN_PARA))
1567     {
1568         SetLastError(E_INVALIDARG);
1569         return FALSE;
1570     }
1571     if (!hChainEngine)
1572         hChainEngine = CRYPT_GetDefaultChainEngine();
1573     /* FIXME: what about HCCE_LOCAL_MACHINE? */
1574     ret = CRYPT_BuildCandidateChainFromCert(hChainEngine, pCertContext, pTime,
1575      hAdditionalStore, &chain);
1576     if (ret)
1577     {
1578         PCertificateChain alternate = NULL;
1579         PCERT_CHAIN_CONTEXT pChain;
1580
1581         do {
1582             alternate = CRYPT_BuildAlternateContextFromChain(hChainEngine,
1583              pTime, hAdditionalStore, chain);
1584
1585             /* Alternate contexts are added as "lower quality" contexts of
1586              * chain, to avoid loops in alternate chain creation.
1587              * The highest-quality chain is chosen at the end.
1588              */
1589             if (alternate)
1590                 ret = CRYPT_AddAlternateChainToChain(chain, alternate);
1591         } while (ret && alternate);
1592         chain = CRYPT_ChooseHighestQualityChain(chain);
1593         if (!(dwFlags & CERT_CHAIN_RETURN_LOWER_QUALITY_CONTEXTS))
1594             CRYPT_FreeLowerQualityChains(chain);
1595         pChain = (PCERT_CHAIN_CONTEXT)chain;
1596         CRYPT_VerifyChainRevocation(pChain, pTime, pChainPara, dwFlags);
1597         if (ppChainContext)
1598             *ppChainContext = pChain;
1599         else
1600             CertFreeCertificateChain(pChain);
1601     }
1602     TRACE("returning %d\n", ret);
1603     return ret;
1604 }
1605
1606 PCCERT_CHAIN_CONTEXT WINAPI CertDuplicateCertificateChain(
1607  PCCERT_CHAIN_CONTEXT pChainContext)
1608 {
1609     PCertificateChain chain = (PCertificateChain)pChainContext;
1610
1611     TRACE("(%p)\n", pChainContext);
1612
1613     if (chain)
1614         InterlockedIncrement(&chain->ref);
1615     return pChainContext;
1616 }
1617
1618 VOID WINAPI CertFreeCertificateChain(PCCERT_CHAIN_CONTEXT pChainContext)
1619 {
1620     PCertificateChain chain = (PCertificateChain)pChainContext;
1621
1622     TRACE("(%p)\n", pChainContext);
1623
1624     if (chain)
1625     {
1626         if (InterlockedDecrement(&chain->ref) == 0)
1627             CRYPT_FreeChainContext(chain);
1628     }
1629 }
1630
1631 static void find_element_with_error(PCCERT_CHAIN_CONTEXT chain, DWORD error,
1632  LONG *iChain, LONG *iElement)
1633 {
1634     DWORD i, j;
1635
1636     for (i = 0; i < chain->cChain; i++)
1637         for (j = 0; j < chain->rgpChain[i]->cElement; j++)
1638             if (chain->rgpChain[i]->rgpElement[j]->TrustStatus.dwErrorStatus &
1639              error)
1640             {
1641                 *iChain = i;
1642                 *iElement = j;
1643                 return;
1644             }
1645 }
1646
1647 static BOOL WINAPI verify_base_policy(LPCSTR szPolicyOID,
1648  PCCERT_CHAIN_CONTEXT pChainContext, PCERT_CHAIN_POLICY_PARA pPolicyPara,
1649  PCERT_CHAIN_POLICY_STATUS pPolicyStatus)
1650 {
1651     pPolicyStatus->lChainIndex = pPolicyStatus->lElementIndex = -1;
1652     if (pChainContext->TrustStatus.dwErrorStatus &
1653      CERT_TRUST_IS_NOT_SIGNATURE_VALID)
1654     {
1655         pPolicyStatus->dwError = TRUST_E_CERT_SIGNATURE;
1656         find_element_with_error(pChainContext,
1657          CERT_TRUST_IS_NOT_SIGNATURE_VALID, &pPolicyStatus->lChainIndex,
1658          &pPolicyStatus->lElementIndex);
1659     }
1660     else if (pChainContext->TrustStatus.dwErrorStatus &
1661      CERT_TRUST_IS_UNTRUSTED_ROOT)
1662     {
1663         pPolicyStatus->dwError = CERT_E_UNTRUSTEDROOT;
1664         find_element_with_error(pChainContext,
1665          CERT_TRUST_IS_UNTRUSTED_ROOT, &pPolicyStatus->lChainIndex,
1666          &pPolicyStatus->lElementIndex);
1667     }
1668     else if (pChainContext->TrustStatus.dwErrorStatus & CERT_TRUST_IS_CYCLIC)
1669     {
1670         pPolicyStatus->dwError = CERT_E_CHAINING;
1671         find_element_with_error(pChainContext, CERT_TRUST_IS_CYCLIC,
1672          &pPolicyStatus->lChainIndex, &pPolicyStatus->lElementIndex);
1673         /* For a cyclic chain, which element is a cycle isn't meaningful */
1674         pPolicyStatus->lElementIndex = -1;
1675     }
1676     else
1677         pPolicyStatus->dwError = NO_ERROR;
1678     return TRUE;
1679 }
1680
1681 static BYTE msTestPubKey1[] = {
1682 0x30,0x47,0x02,0x40,0x81,0x55,0x22,0xb9,0x8a,0xa4,0x6f,0xed,0xd6,0xe7,0xd9,
1683 0x66,0x0f,0x55,0xbc,0xd7,0xcd,0xd5,0xbc,0x4e,0x40,0x02,0x21,0xa2,0xb1,0xf7,
1684 0x87,0x30,0x85,0x5e,0xd2,0xf2,0x44,0xb9,0xdc,0x9b,0x75,0xb6,0xfb,0x46,0x5f,
1685 0x42,0xb6,0x9d,0x23,0x36,0x0b,0xde,0x54,0x0f,0xcd,0xbd,0x1f,0x99,0x2a,0x10,
1686 0x58,0x11,0xcb,0x40,0xcb,0xb5,0xa7,0x41,0x02,0x03,0x01,0x00,0x01 };
1687 static BYTE msTestPubKey2[] = {
1688 0x30,0x47,0x02,0x40,0x9c,0x50,0x05,0x1d,0xe2,0x0e,0x4c,0x53,0xd8,0xd9,0xb5,
1689 0xe5,0xfd,0xe9,0xe3,0xad,0x83,0x4b,0x80,0x08,0xd9,0xdc,0xe8,0xe8,0x35,0xf8,
1690 0x11,0xf1,0xe9,0x9b,0x03,0x7a,0x65,0x64,0x76,0x35,0xce,0x38,0x2c,0xf2,0xb6,
1691 0x71,0x9e,0x06,0xd9,0xbf,0xbb,0x31,0x69,0xa3,0xf6,0x30,0xa0,0x78,0x7b,0x18,
1692 0xdd,0x50,0x4d,0x79,0x1e,0xeb,0x61,0xc1,0x02,0x03,0x01,0x00,0x01 };
1693
1694 static BOOL WINAPI verify_authenticode_policy(LPCSTR szPolicyOID,
1695  PCCERT_CHAIN_CONTEXT pChainContext, PCERT_CHAIN_POLICY_PARA pPolicyPara,
1696  PCERT_CHAIN_POLICY_STATUS pPolicyStatus)
1697 {
1698     BOOL ret = verify_base_policy(szPolicyOID, pChainContext, pPolicyPara,
1699      pPolicyStatus);
1700
1701     if (ret && pPolicyStatus->dwError == CERT_E_UNTRUSTEDROOT)
1702     {
1703         CERT_PUBLIC_KEY_INFO msPubKey = { { 0 } };
1704         BOOL isMSTestRoot = FALSE;
1705         PCCERT_CONTEXT failingCert =
1706          pChainContext->rgpChain[pPolicyStatus->lChainIndex]->
1707          rgpElement[pPolicyStatus->lElementIndex]->pCertContext;
1708         DWORD i;
1709         CRYPT_DATA_BLOB keyBlobs[] = {
1710          { sizeof(msTestPubKey1), msTestPubKey1 },
1711          { sizeof(msTestPubKey2), msTestPubKey2 },
1712         };
1713
1714         /* Check whether the root is an MS test root */
1715         for (i = 0; !isMSTestRoot && i < sizeof(keyBlobs) / sizeof(keyBlobs[0]);
1716          i++)
1717         {
1718             msPubKey.PublicKey.cbData = keyBlobs[i].cbData;
1719             msPubKey.PublicKey.pbData = keyBlobs[i].pbData;
1720             if (CertComparePublicKeyInfo(
1721              X509_ASN_ENCODING | PKCS_7_ASN_ENCODING,
1722              &failingCert->pCertInfo->SubjectPublicKeyInfo, &msPubKey))
1723                 isMSTestRoot = TRUE;
1724         }
1725         if (isMSTestRoot)
1726             pPolicyStatus->dwError = CERT_E_UNTRUSTEDTESTROOT;
1727     }
1728     return ret;
1729 }
1730
1731 static BOOL WINAPI verify_basic_constraints_policy(LPCSTR szPolicyOID,
1732  PCCERT_CHAIN_CONTEXT pChainContext, PCERT_CHAIN_POLICY_PARA pPolicyPara,
1733  PCERT_CHAIN_POLICY_STATUS pPolicyStatus)
1734 {
1735     pPolicyStatus->lChainIndex = pPolicyStatus->lElementIndex = -1;
1736     if (pChainContext->TrustStatus.dwErrorStatus &
1737      CERT_TRUST_INVALID_BASIC_CONSTRAINTS)
1738     {
1739         pPolicyStatus->dwError = TRUST_E_BASIC_CONSTRAINTS;
1740         find_element_with_error(pChainContext,
1741          CERT_TRUST_INVALID_BASIC_CONSTRAINTS, &pPolicyStatus->lChainIndex,
1742          &pPolicyStatus->lElementIndex);
1743     }
1744     else
1745         pPolicyStatus->dwError = NO_ERROR;
1746     return TRUE;
1747 }
1748
1749 static BYTE msPubKey1[] = {
1750 0x30,0x82,0x01,0x0a,0x02,0x82,0x01,0x01,0x00,0xdf,0x08,0xba,0xe3,0x3f,0x6e,
1751 0x64,0x9b,0xf5,0x89,0xaf,0x28,0x96,0x4a,0x07,0x8f,0x1b,0x2e,0x8b,0x3e,0x1d,
1752 0xfc,0xb8,0x80,0x69,0xa3,0xa1,0xce,0xdb,0xdf,0xb0,0x8e,0x6c,0x89,0x76,0x29,
1753 0x4f,0xca,0x60,0x35,0x39,0xad,0x72,0x32,0xe0,0x0b,0xae,0x29,0x3d,0x4c,0x16,
1754 0xd9,0x4b,0x3c,0x9d,0xda,0xc5,0xd3,0xd1,0x09,0xc9,0x2c,0x6f,0xa6,0xc2,0x60,
1755 0x53,0x45,0xdd,0x4b,0xd1,0x55,0xcd,0x03,0x1c,0xd2,0x59,0x56,0x24,0xf3,0xe5,
1756 0x78,0xd8,0x07,0xcc,0xd8,0xb3,0x1f,0x90,0x3f,0xc0,0x1a,0x71,0x50,0x1d,0x2d,
1757 0xa7,0x12,0x08,0x6d,0x7c,0xb0,0x86,0x6c,0xc7,0xba,0x85,0x32,0x07,0xe1,0x61,
1758 0x6f,0xaf,0x03,0xc5,0x6d,0xe5,0xd6,0xa1,0x8f,0x36,0xf6,0xc1,0x0b,0xd1,0x3e,
1759 0x69,0x97,0x48,0x72,0xc9,0x7f,0xa4,0xc8,0xc2,0x4a,0x4c,0x7e,0xa1,0xd1,0x94,
1760 0xa6,0xd7,0xdc,0xeb,0x05,0x46,0x2e,0xb8,0x18,0xb4,0x57,0x1d,0x86,0x49,0xdb,
1761 0x69,0x4a,0x2c,0x21,0xf5,0x5e,0x0f,0x54,0x2d,0x5a,0x43,0xa9,0x7a,0x7e,0x6a,
1762 0x8e,0x50,0x4d,0x25,0x57,0xa1,0xbf,0x1b,0x15,0x05,0x43,0x7b,0x2c,0x05,0x8d,
1763 0xbd,0x3d,0x03,0x8c,0x93,0x22,0x7d,0x63,0xea,0x0a,0x57,0x05,0x06,0x0a,0xdb,
1764 0x61,0x98,0x65,0x2d,0x47,0x49,0xa8,0xe7,0xe6,0x56,0x75,0x5c,0xb8,0x64,0x08,
1765 0x63,0xa9,0x30,0x40,0x66,0xb2,0xf9,0xb6,0xe3,0x34,0xe8,0x67,0x30,0xe1,0x43,
1766 0x0b,0x87,0xff,0xc9,0xbe,0x72,0x10,0x5e,0x23,0xf0,0x9b,0xa7,0x48,0x65,0xbf,
1767 0x09,0x88,0x7b,0xcd,0x72,0xbc,0x2e,0x79,0x9b,0x7b,0x02,0x03,0x01,0x00,0x01 };
1768 static BYTE msPubKey2[] = {
1769 0x30,0x82,0x01,0x0a,0x02,0x82,0x01,0x01,0x00,0xa9,0x02,0xbd,0xc1,0x70,0xe6,
1770 0x3b,0xf2,0x4e,0x1b,0x28,0x9f,0x97,0x78,0x5e,0x30,0xea,0xa2,0xa9,0x8d,0x25,
1771 0x5f,0xf8,0xfe,0x95,0x4c,0xa3,0xb7,0xfe,0x9d,0xa2,0x20,0x3e,0x7c,0x51,0xa2,
1772 0x9b,0xa2,0x8f,0x60,0x32,0x6b,0xd1,0x42,0x64,0x79,0xee,0xac,0x76,0xc9,0x54,
1773 0xda,0xf2,0xeb,0x9c,0x86,0x1c,0x8f,0x9f,0x84,0x66,0xb3,0xc5,0x6b,0x7a,0x62,
1774 0x23,0xd6,0x1d,0x3c,0xde,0x0f,0x01,0x92,0xe8,0x96,0xc4,0xbf,0x2d,0x66,0x9a,
1775 0x9a,0x68,0x26,0x99,0xd0,0x3a,0x2c,0xbf,0x0c,0xb5,0x58,0x26,0xc1,0x46,0xe7,
1776 0x0a,0x3e,0x38,0x96,0x2c,0xa9,0x28,0x39,0xa8,0xec,0x49,0x83,0x42,0xe3,0x84,
1777 0x0f,0xbb,0x9a,0x6c,0x55,0x61,0xac,0x82,0x7c,0xa1,0x60,0x2d,0x77,0x4c,0xe9,
1778 0x99,0xb4,0x64,0x3b,0x9a,0x50,0x1c,0x31,0x08,0x24,0x14,0x9f,0xa9,0xe7,0x91,
1779 0x2b,0x18,0xe6,0x3d,0x98,0x63,0x14,0x60,0x58,0x05,0x65,0x9f,0x1d,0x37,0x52,
1780 0x87,0xf7,0xa7,0xef,0x94,0x02,0xc6,0x1b,0xd3,0xbf,0x55,0x45,0xb3,0x89,0x80,
1781 0xbf,0x3a,0xec,0x54,0x94,0x4e,0xae,0xfd,0xa7,0x7a,0x6d,0x74,0x4e,0xaf,0x18,
1782 0xcc,0x96,0x09,0x28,0x21,0x00,0x57,0x90,0x60,0x69,0x37,0xbb,0x4b,0x12,0x07,
1783 0x3c,0x56,0xff,0x5b,0xfb,0xa4,0x66,0x0a,0x08,0xa6,0xd2,0x81,0x56,0x57,0xef,
1784 0xb6,0x3b,0x5e,0x16,0x81,0x77,0x04,0xda,0xf6,0xbe,0xae,0x80,0x95,0xfe,0xb0,
1785 0xcd,0x7f,0xd6,0xa7,0x1a,0x72,0x5c,0x3c,0xca,0xbc,0xf0,0x08,0xa3,0x22,0x30,
1786 0xb3,0x06,0x85,0xc9,0xb3,0x20,0x77,0x13,0x85,0xdf,0x02,0x03,0x01,0x00,0x01 };
1787 static BYTE msPubKey3[] = {
1788 0x30,0x82,0x02,0x0a,0x02,0x82,0x02,0x01,0x00,0xf3,0x5d,0xfa,0x80,0x67,0xd4,
1789 0x5a,0xa7,0xa9,0x0c,0x2c,0x90,0x20,0xd0,0x35,0x08,0x3c,0x75,0x84,0xcd,0xb7,
1790 0x07,0x89,0x9c,0x89,0xda,0xde,0xce,0xc3,0x60,0xfa,0x91,0x68,0x5a,0x9e,0x94,
1791 0x71,0x29,0x18,0x76,0x7c,0xc2,0xe0,0xc8,0x25,0x76,0x94,0x0e,0x58,0xfa,0x04,
1792 0x34,0x36,0xe6,0xdf,0xaf,0xf7,0x80,0xba,0xe9,0x58,0x0b,0x2b,0x93,0xe5,0x9d,
1793 0x05,0xe3,0x77,0x22,0x91,0xf7,0x34,0x64,0x3c,0x22,0x91,0x1d,0x5e,0xe1,0x09,
1794 0x90,0xbc,0x14,0xfe,0xfc,0x75,0x58,0x19,0xe1,0x79,0xb7,0x07,0x92,0xa3,0xae,
1795 0x88,0x59,0x08,0xd8,0x9f,0x07,0xca,0x03,0x58,0xfc,0x68,0x29,0x6d,0x32,0xd7,
1796 0xd2,0xa8,0xcb,0x4b,0xfc,0xe1,0x0b,0x48,0x32,0x4f,0xe6,0xeb,0xb8,0xad,0x4f,
1797 0xe4,0x5c,0x6f,0x13,0x94,0x99,0xdb,0x95,0xd5,0x75,0xdb,0xa8,0x1a,0xb7,0x94,
1798 0x91,0xb4,0x77,0x5b,0xf5,0x48,0x0c,0x8f,0x6a,0x79,0x7d,0x14,0x70,0x04,0x7d,
1799 0x6d,0xaf,0x90,0xf5,0xda,0x70,0xd8,0x47,0xb7,0xbf,0x9b,0x2f,0x6c,0xe7,0x05,
1800 0xb7,0xe1,0x11,0x60,0xac,0x79,0x91,0x14,0x7c,0xc5,0xd6,0xa6,0xe4,0xe1,0x7e,
1801 0xd5,0xc3,0x7e,0xe5,0x92,0xd2,0x3c,0x00,0xb5,0x36,0x82,0xde,0x79,0xe1,0x6d,
1802 0xf3,0xb5,0x6e,0xf8,0x9f,0x33,0xc9,0xcb,0x52,0x7d,0x73,0x98,0x36,0xdb,0x8b,
1803 0xa1,0x6b,0xa2,0x95,0x97,0x9b,0xa3,0xde,0xc2,0x4d,0x26,0xff,0x06,0x96,0x67,
1804 0x25,0x06,0xc8,0xe7,0xac,0xe4,0xee,0x12,0x33,0x95,0x31,0x99,0xc8,0x35,0x08,
1805 0x4e,0x34,0xca,0x79,0x53,0xd5,0xb5,0xbe,0x63,0x32,0x59,0x40,0x36,0xc0,0xa5,
1806 0x4e,0x04,0x4d,0x3d,0xdb,0x5b,0x07,0x33,0xe4,0x58,0xbf,0xef,0x3f,0x53,0x64,
1807 0xd8,0x42,0x59,0x35,0x57,0xfd,0x0f,0x45,0x7c,0x24,0x04,0x4d,0x9e,0xd6,0x38,
1808 0x74,0x11,0x97,0x22,0x90,0xce,0x68,0x44,0x74,0x92,0x6f,0xd5,0x4b,0x6f,0xb0,
1809 0x86,0xe3,0xc7,0x36,0x42,0xa0,0xd0,0xfc,0xc1,0xc0,0x5a,0xf9,0xa3,0x61,0xb9,
1810 0x30,0x47,0x71,0x96,0x0a,0x16,0xb0,0x91,0xc0,0x42,0x95,0xef,0x10,0x7f,0x28,
1811 0x6a,0xe3,0x2a,0x1f,0xb1,0xe4,0xcd,0x03,0x3f,0x77,0x71,0x04,0xc7,0x20,0xfc,
1812 0x49,0x0f,0x1d,0x45,0x88,0xa4,0xd7,0xcb,0x7e,0x88,0xad,0x8e,0x2d,0xec,0x45,
1813 0xdb,0xc4,0x51,0x04,0xc9,0x2a,0xfc,0xec,0x86,0x9e,0x9a,0x11,0x97,0x5b,0xde,
1814 0xce,0x53,0x88,0xe6,0xe2,0xb7,0xfd,0xac,0x95,0xc2,0x28,0x40,0xdb,0xef,0x04,
1815 0x90,0xdf,0x81,0x33,0x39,0xd9,0xb2,0x45,0xa5,0x23,0x87,0x06,0xa5,0x55,0x89,
1816 0x31,0xbb,0x06,0x2d,0x60,0x0e,0x41,0x18,0x7d,0x1f,0x2e,0xb5,0x97,0xcb,0x11,
1817 0xeb,0x15,0xd5,0x24,0xa5,0x94,0xef,0x15,0x14,0x89,0xfd,0x4b,0x73,0xfa,0x32,
1818 0x5b,0xfc,0xd1,0x33,0x00,0xf9,0x59,0x62,0x70,0x07,0x32,0xea,0x2e,0xab,0x40,
1819 0x2d,0x7b,0xca,0xdd,0x21,0x67,0x1b,0x30,0x99,0x8f,0x16,0xaa,0x23,0xa8,0x41,
1820 0xd1,0xb0,0x6e,0x11,0x9b,0x36,0xc4,0xde,0x40,0x74,0x9c,0xe1,0x58,0x65,0xc1,
1821 0x60,0x1e,0x7a,0x5b,0x38,0xc8,0x8f,0xbb,0x04,0x26,0x7c,0xd4,0x16,0x40,0xe5,
1822 0xb6,0x6b,0x6c,0xaa,0x86,0xfd,0x00,0xbf,0xce,0xc1,0x35,0x02,0x03,0x01,0x00,
1823 0x01 };
1824
1825 static BOOL WINAPI verify_ms_root_policy(LPCSTR szPolicyOID,
1826  PCCERT_CHAIN_CONTEXT pChainContext, PCERT_CHAIN_POLICY_PARA pPolicyPara,
1827  PCERT_CHAIN_POLICY_STATUS pPolicyStatus)
1828 {
1829     BOOL ret = verify_base_policy(szPolicyOID, pChainContext, pPolicyPara,
1830      pPolicyStatus);
1831
1832     if (ret && !pPolicyStatus->dwError)
1833     {
1834         CERT_PUBLIC_KEY_INFO msPubKey = { { 0 } };
1835         BOOL isMSRoot = FALSE;
1836         DWORD i;
1837         CRYPT_DATA_BLOB keyBlobs[] = {
1838          { sizeof(msPubKey1), msPubKey1 },
1839          { sizeof(msPubKey2), msPubKey2 },
1840          { sizeof(msPubKey3), msPubKey3 },
1841         };
1842         PCERT_SIMPLE_CHAIN rootChain =
1843          pChainContext->rgpChain[pChainContext->cChain -1 ];
1844         PCCERT_CONTEXT root =
1845          rootChain->rgpElement[rootChain->cElement - 1]->pCertContext;
1846
1847         for (i = 0; !isMSRoot && i < sizeof(keyBlobs) / sizeof(keyBlobs[0]);
1848          i++)
1849         {
1850             msPubKey.PublicKey.cbData = keyBlobs[i].cbData;
1851             msPubKey.PublicKey.pbData = keyBlobs[i].pbData;
1852             if (CertComparePublicKeyInfo(
1853              X509_ASN_ENCODING | PKCS_7_ASN_ENCODING,
1854              &root->pCertInfo->SubjectPublicKeyInfo, &msPubKey))
1855                 isMSRoot = TRUE;
1856         }
1857         if (isMSRoot)
1858             pPolicyStatus->lChainIndex = pPolicyStatus->lElementIndex = 0;
1859     }
1860     return ret;
1861 }
1862
1863 typedef BOOL (WINAPI *CertVerifyCertificateChainPolicyFunc)(LPCSTR szPolicyOID,
1864  PCCERT_CHAIN_CONTEXT pChainContext, PCERT_CHAIN_POLICY_PARA pPolicyPara,
1865  PCERT_CHAIN_POLICY_STATUS pPolicyStatus);
1866
1867 BOOL WINAPI CertVerifyCertificateChainPolicy(LPCSTR szPolicyOID,
1868  PCCERT_CHAIN_CONTEXT pChainContext, PCERT_CHAIN_POLICY_PARA pPolicyPara,
1869  PCERT_CHAIN_POLICY_STATUS pPolicyStatus)
1870 {
1871     static HCRYPTOIDFUNCSET set = NULL;
1872     BOOL ret = FALSE;
1873     CertVerifyCertificateChainPolicyFunc verifyPolicy = NULL;
1874     HCRYPTOIDFUNCADDR hFunc = NULL;
1875
1876     TRACE("(%s, %p, %p, %p)\n", debugstr_a(szPolicyOID), pChainContext,
1877      pPolicyPara, pPolicyStatus);
1878
1879     if (!HIWORD(szPolicyOID))
1880     {
1881         switch (LOWORD(szPolicyOID))
1882         {
1883         case LOWORD(CERT_CHAIN_POLICY_BASE):
1884             verifyPolicy = verify_base_policy;
1885             break;
1886         case LOWORD(CERT_CHAIN_POLICY_AUTHENTICODE):
1887             verifyPolicy = verify_authenticode_policy;
1888             break;
1889         case LOWORD(CERT_CHAIN_POLICY_BASIC_CONSTRAINTS):
1890             verifyPolicy = verify_basic_constraints_policy;
1891             break;
1892         case LOWORD(CERT_CHAIN_POLICY_MICROSOFT_ROOT):
1893             verifyPolicy = verify_ms_root_policy;
1894             break;
1895         default:
1896             FIXME("unimplemented for %d\n", LOWORD(szPolicyOID));
1897         }
1898     }
1899     if (!verifyPolicy)
1900     {
1901         if (!set)
1902             set = CryptInitOIDFunctionSet(
1903              CRYPT_OID_VERIFY_CERTIFICATE_CHAIN_POLICY_FUNC, 0);
1904         CryptGetOIDFunctionAddress(set, X509_ASN_ENCODING, szPolicyOID, 0,
1905          (void **)&verifyPolicy, &hFunc);
1906     }
1907     if (verifyPolicy)
1908         ret = verifyPolicy(szPolicyOID, pChainContext, pPolicyPara,
1909          pPolicyStatus);
1910     if (hFunc)
1911         CryptFreeOIDFunctionAddress(hFunc, 0);
1912     return ret;
1913 }