COSERVERINFO 结构 (objidl.h)

项目
02/29/2024

标识激活函数的远程计算机资源。

语法

typedef struct _COSERVERINFO {
  DWORD      dwReserved1;
  LPWSTR     pwszName;
  COAUTHINFO *pAuthInfo;
  DWORD      dwReserved2;
} COSERVERINFO;

成员

dwReserved1

此成员是保留的，必须为 0。

pwszName

计算机的名称。

pAuthInfo

指向 COAUTHINFO 结构的指针，用于替代计算机远程激活的默认激活安全性。否则，设置为 NULL 以指示应使用默认值。有关详细信息，请参见“备注”部分。

dwReserved2

此成员是保留的，必须为 0。

注解

COSERVERINFO 结构主要用于在对象创建函数中标识远程系统。计算机资源是使用网络传输的命名方案命名的。默认情况下，允许所有 UNC (“\\server”或“server”) 和 DNS 名称 (“domain.com”、“example.microsoft.com”或“135.5.33.19”) 名称。

如果 pAuthInfo 设置为 NULL，则 Snego 将用于协商在客户端和服务器之间工作的身份验证服务。但是，可以为 pAuthInfo 指定非 NULLCOAUTHINFO 结构，以满足以下任一需求：

为计算机远程激活指定其他客户端标识。指定的标识将用于服务器上的启动权限检查，而不是实际的客户端标识。
指定 Kerberos（而不是 NTLMSSP）用于计算机远程激活。可以指定或未指定非默认客户端标识。
请求不安全的激活。
指定专有身份验证服务。

如果 pAuthInfo 不为 NULL，则这些值将用于指定远程调用的身份验证设置。这些设置将传递给 RpcBindingSetAuthInfoEx 函数。

如果 pAuthInfo 参数为 NULL，则可以由 CoInitializeSecurity 函数设置的身份验证级别覆盖 dwAuthnLevel。如果未调用 CoInitializeSecurity 函数，则使用 AppID 注册表项下指定的身份验证级别（如果存在）。

从具有 Service Pack 2 的 Windows XP (SP2) 开始， dwAuthnLevel 是发出激活请求的客户端进程的最大RPC_C_AUTHN_LEVEL_CONNECT和进程范围的身份验证级别。对于早期版本的操作系统，这是RPC_C_AUTHN_LEVEL_CONNECT。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows 2000 Server [桌面应用 \|UWP 应用]
标头	objidl.h (包括 Objidl.h)