Windows下C++ x64 Unicode环境SChannel凭据句柄获取失败问题

1. UNISP_NAME类型不兼容的解决 #

AcquireCredentialsHandleW的pszServiceName参数声明为LPWSTR（非const宽字符指针），但Unicode环境下UNISP_NAME是const wchar_t*类型的预定义宏，因此编译器会抛出类型不兼容错误。

实际上微软文档明确标注该参数为输入参数，函数不会修改其内容，因此可以安全使用const_cast做类型转换：

SECURITY_STATUS status = AcquireCredentialsHandleW(
    NULL,
    const_cast<LPWSTR>(UNISP_NAME),
    SECPKG_CRED_OUTBOUND,
    NULL,
    cred,
    NULL,
    NULL,
    &hCred,
    &tsExpiry
);

2. 结构体未初始化导致的凭据获取失败 #

你通过new创建的SCHANNEL_CRED结构体未做初始化，除了你手动设置的几个成员外，其余成员（如cCreds、pCreds、hRootStore等）会带有随机垃圾值，这会直接导致AcquireCredentialsHandleW执行失败。

正确的做法是先将整个结构体初始化为0，再配置必要参数：

// 栈上初始化（推荐）
SCHANNEL_CRED cred = {0};
cred.dwVersion = SCHANNEL_CRED_VERSION;
cred.dwFlags = SCH_USE_STRONG_CRYPTO | SCH_CRED_AUTO_CRED_VALIDATION | SCH_CRED_NO_DEFAULT_CREDS;
cred.grbitEnabledProtocols = SP_PROT_TLS1_2;

// 若使用堆分配，需手动初始化
SCHANNEL_CRED* cred = new SCHANNEL_CRED;
memset(cred, 0, sizeof(SCHANNEL_CRED));
cred->dwVersion = SCHANNEL_CRED_VERSION;
// 后续参数配置同上

3. 排查失败的关键步骤 #

如果仍然获取凭据失败，必须检查函数返回的SECURITY_STATUS错误码：

• 判断返回值是否为SEC_E_OK，非该值即为失败
• 可通过FormatMessageW将错误码转换为可读描述，或参考微软官方文档中SChannel错误码的定义定位问题

补充说明 #

• 无需手动构造服务名字符串，直接使用系统预定义的UNISP_NAME宏即可，它是SChannel服务的标准名称
• 若切换多字节环境，需对应使用AcquireCredentialsHandleA和UNISP_NAME_A宏，避免编码混乱

内容的提问来源于stack exchange，提问作者0x38