如何通过Windows CNG API获取智能卡剩余PIN尝试次数及锁定状态？

我已通过以下代码成功获取证书及其私钥：

PCCERT_CONTEXT cert = NULL;
if (!(cert = CertFindCertificateInStore(sys, X509_ASN_ENCODING, 0, CERT_FIND_EXISTING, search, NULL))) {
    // error handling
}

CertFreeCertificateContext(search);

NCRYPT_HANDLE key;
DWORD dwKeySpec = 0;
if (!CryptAcquireCertificatePrivateKey(cert, CRYPT_ACQUIRE_CACHE_FLAG | CRYPT_ACQUIRE_COMPARE_KEY_FLAG | CRYPT_ACQUIRE_SILENT_FLAG | CRYPT_ACQUIRE_ONLY_NCRYPT_KEY_FLAG, NULL, &key, &dwKeySpec, NULL))
{
    // error handling
}

PIN_INFO pin_info;
DWORD pin_info_size = sizeof(PIN_INFO);
NCryptGetProperty(key, NCRYPT_SCARD_PIN_INFO, (PBYTE)&pin_info, pin_info_size, &pin_info_size, 0);
if (pin_info_size)
{
    // success
}

// obtain PIN attempt remaining from key

我可通过NCryptGetProperty获取私钥PIN的相关细节，但缺少核心信息：剩余PIN尝试次数及PIN是否锁定。我知晓PKCS11 API可实现该功能，但无法通过CNG API获取。请问需使用哪个Windows API来获取上述信息？最终目的是提升用户体验。

要获取智能卡私钥的剩余PIN尝试次数及锁定状态，可使用WinSCard API（PC/SC标准接口）结合智能卡上下文实现，具体步骤如下：

• 获取关联的智能卡连接信息
  从已获取的NCRYPT_HANDLE出发，通过NCryptGetProperty查询NCRYPT_SCARD_READER_PROPERTY和NCRYPT_SCARD_CARD_NAME_PROPERTY，直接拿到对应智能卡的读卡器名称和卡片名称，无需手动枚举设备。

• 建立智能卡连接并发送APDU命令
  用SCardEstablishContext初始化PC/SC上下文，通过SCardConnect连接到目标智能卡，再调用SCardTransmit发送标准或厂商特定的APDU命令查询PIN状态。例如：

  • 符合GlobalPlatform标准的卡片可发送00 20 00 81 00命令获取PIN信息
  • 多数PKCS#11兼容卡片支持厂商自定义APDU返回剩余尝试次数与锁定状态
    解析APDU返回的数据即可提取所需的状态信息。

• 兼容性 fallback 方案
  部分智能卡驱动会扩展CNG属性，可先尝试查询NCRYPT_PIN_REMAINING_ATTEMPTS_PROPERTY，若返回失败再切换到WinSCard的APDU通信方式，确保覆盖更多设备场景。

WinSCard API是Windows平台上获取智能卡PIN精准状态的可靠方案，通过直接与卡片底层通信，能准确获取剩余尝试次数和锁定状态，帮助优化用户输入PIN时的体验提示。

内容的提问来源于stack exchange，提问作者Graham Leggett