COSERVERINFO 结构 (objidl.h)

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

语法

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)

另请参阅

激活安全性

COAUTHINFO

CoCreateInstanceEx

CoGetClassObject

CoGetInstanceFromFile

CoGetInstanceFromIStorage

关闭激活安全性