CoSetProxyBlanket 函数 (combaseapi.h)

项目
02/28/2024

设置将用于对指定代理进行调用的身份验证信息。这是 IClientSecurity：：SetBlanket 的帮助程序函数。

语法

HRESULT CoSetProxyBlanket(
  [in]           IUnknown                 *pProxy,
  [in]           DWORD                    dwAuthnSvc,
  [in]           DWORD                    dwAuthzSvc,
  [in, optional] OLECHAR                  *pServerPrincName,
  [in]           DWORD                    dwAuthnLevel,
  [in]           DWORD                    dwImpLevel,
  [in, optional] RPC_AUTH_IDENTITY_HANDLE pAuthInfo,
  [in]           DWORD                    dwCapabilities
);

参数

[in] pProxy

要设置的代理。

[in] dwAuthnSvc

要使用的身份验证服务。有关可能值的列表，请参阅身份验证服务常量。如果不需要身份验证，请使用 RPC_C_AUTHN_NONE。如果指定了RPC_C_AUTHN_DEFAULT，DCOM 将按照其常规安全一揽子协商算法选择身份验证服务。

[in] dwAuthzSvc

要使用的授权服务。有关可能值的列表，请参阅授权常量。如果指定了RPC_C_AUTHZ_DEFAULT，DCOM 将按照其正常的安全一揽子协商算法选择授权服务。如果使用 NTLMSSP、Kerberos 或 Schannel 作为身份验证服务，则应将RPC_C_AUTHZ_NONE用作授权服务。

[in, optional] pServerPrincName

要与身份验证服务一起使用的服务器主体名称。如果指定了COLE_DEFAULT_PRINCIPAL，DCOM 将使用其安全总协商算法选取主体名称。如果使用 Kerberos 作为身份验证服务，则此值不得为 NULL。它必须是服务器的正确主体名称，否则调用将失败。

如果使用 Schannel 作为身份验证服务，则此值必须是主体名称中所述的 msstd 或 fullsic 形式之一;如果不需要相互身份验证，此值必须为 NULL 。

通常，指定 NULL 不会重置代理上的服务器主体名称;相反，将保留以前的设置。在为代理选择其他身份验证服务时，使用 NULL 作为 pServerPrincName 时必须小心，因为无法保证以前设置的主体名称对新选择的身份验证服务有效。

[in] dwAuthnLevel

要使用的身份验证级别。有关可能值的列表，请参阅身份验证级别常量。如果指定了RPC_C_AUTHN_LEVEL_DEFAULT，DCOM 将按照其常规安全一揽子协商算法选择身份验证级别。如果此值为 none，则身份验证服务也必须为 none。

[in] dwImpLevel

要使用的模拟级别。有关可能值的列表，请参阅模拟级别常量。如果指定了RPC_C_IMP_LEVEL_DEFAULT，DCOM 将按照其正常的安全一揽子协商算法选择模拟级别。如果 NTLMSSP 是身份验证服务，则必须RPC_C_IMP_LEVEL_IMPERSONATE或RPC_C_IMP_LEVEL_IDENTIFY此值。 NTLMSSP 还支持同一计算机上的委托级模拟 (RPC_C_IMP_LEVEL_DELEGATE) 。如果 Schannel 是身份验证服务，则必须RPC_C_IMP_LEVEL_IMPERSONATE此参数。

[in, optional] pAuthInfo

指向建立客户端标识 的RPC_AUTH_IDENTITY_HANDLE 值的指针。句柄引用的结构的格式取决于身份验证服务的提供程序。

对于同一计算机上的调用，RPC 使用提供的凭据记录用户，并使用生成的令牌进行方法调用。

对于 NTLMSSP 或 Kerberos，结构是 SEC_WINNT_AUTH_IDENTITY 或 SEC_WINNT_AUTH_IDENTITY_EX 结构。客户端可以在调用 API 后放弃 pAuthInfo 。 RPC 不保留 pAuthInfo 指针的副本，并且客户端稍后无法在 CoQueryProxyBlanket 方法中检索它。

如果此参数为 NULL，DCOM 将使用当前代理标识 (该标识是进程令牌或模拟令牌) 。如果句柄引用结构，则使用该标识。

对于 Schannel，此参数必须是指向包含客户端 X.509 证书的 CERT_CONTEXT 结构的指针，如果客户端希望与服务器建立匿名连接，则此参数必须为 NULL 。如果指定了证书，则只要当前单元中存在对象的任何代理，调用方就不得释放该证书。

对于 Snego，此成员为 NULL，指向 SEC_WINNT_AUTH_IDENTITY 结构，或指向 SEC_WINNT_AUTH_IDENTITY_EX 结构。如果为 NULL，Snego 将根据客户端计算机上可用的身份验证服务选择一个列表。如果它指向 SEC_WINNT_AUTH_IDENTITY_EX 结构，则结构的 PackageList 成员必须指向包含以逗号分隔的身份验证服务名称列表的字符串， 而 PackageListLength 成员必须提供 PackageList 字符串中的字节数。如果 PackageList 为 NULL，则使用 Snego 的所有调用都将失败。

如果为此参数指定了COLE_DEFAULT_AUTHINFO，则 DCOM 将按照其常规安全一揽子协商算法选择身份验证信息。

如果设置了 pAuthInfo 并在 dwCapabilities 参数中设置了其中一个隐藏标志，CoSetProxyBlanket 将失败。

[in] dwCapabilities

此代理的功能。有关可能值的列表，请参阅 EOLE_AUTHENTICATION_CAPABILITIES 枚举。唯一可以通过此函数设置的标志是EOAC_MUTUAL_AUTH、EOAC_STATIC_CLOAKING、EOAC_DYNAMIC_CLOAKING，EOAC_ANY_AUTHORITY (此标志已弃用) 、EOAC_MAKE_FULLSIC和EOAC_DEFAULT。如果未设置 pAuthInfo 且 Schannel 不是身份验证服务，则可以设置 EOAC_STATIC_CLOAKING 或 EOAC_DYNAMIC_CLOAKING。 (有关详细信息，请参阅隐藏。) 如果设置了此处提及的功能以外的任何功能标志， CoSetProxyBlanket 将失败。

返回值

此函数可以返回以下值。

返回代码	说明
S_OK	函数成功。
E_INVALIDARG	一个或多个参数无效。

注解

CoSetProxyBlanket 设置将用于对指定代理进行调用的身份验证信息。此函数封装以下常见调用序列， (排除的错误处理) 。

    pProxy->QueryInterface(IID_IClientSecurity, (void**)&pcs);
    pcs->SetBlanket(pProxy, dwAuthnSvc, dwAuthzSvc, pServerPrincName, 
        dwAuthnLevel, dwImpLevel, pAuthInfo, dwCapabilities);
    pcs->Release();

此序列在代理上调用 QueryInterface 以获取指向 IClientSecurity 的指针，并使用生成的指针调用 IClientSecurity：：SetBlanket ，然后释放指针。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	combaseapi.h (包括 Objbase.h)
Library	Ole32.lib
DLL	Ole32.dll

另请参阅

CoQueryProxyBlanket

IClientSecurity：：SetBlanket

COM 中的安全性

在接口代理级别设置安全性

通过

CoSetProxyBlanket 函数 (combaseapi.h)

语法

参数

返回值

注解

要求

另请参阅

反馈

其他资源