通过 DCOM 创建到指定计算机上的 WMI 命名空间的连接。
Note: 此 API 仅供内部使用。 不应从开发人员代码中使用。
语法
HRESULT ConnectServerWmi (
[in] BSTR strNetworkResource,
[in] BSTR strUser,
[in] BSTR strPassword,
[in] BSTR strLocale,
[in] long lSecurityFlags,
[in] BSTR strAuthority,
[in] IWbemContext* pCtx,
[out] IWbemServices** ppNamespace,
[in] DWORD impLevel,
[in] DWORD authLevel
);
参数
strNetworkResource
[in]指向有效BSTR包含正确的 WMI 命名空间的对象路径。 请参阅备注部分,了解详细信息。
strUser
[in]指向一个有效的指针BSTR,其中包含的用户名称。 一个null值指示当前的安全上下文。 如果用户是从不同的域与当前strUser还可以包含一个反斜杠分隔的域和用户名称。 strUser 也可以是用户主体名称 (UPN) 格式,如userName@domainName。 请参阅备注部分,了解详细信息。
strPassword
[in]指向一个有效的指针BSTR包含的密码。 一个null指示当前的安全上下文。 空字符串 ("") 指示有效长度为零的密码。
strLocale
[in]指向一个有效的指针BSTR,该值指示正确的区域设置的信息检索。 对于 Microsoft 区域设置标识符的字符串的格式是"MS_xxx",其中xxx是一个字符串中指示的区域设置标识符 (LCID) 的十六进制格式。 如果指定了无效的区域设置,该方法返回WBEM_E_INVALID_PARAMETER上 Windows 7,其中的服务器的默认区域设置改为使用除外。 如果使用 null1,当前区域设置。
lSecurityFlags
[in]要传递给标志ConnectServerWmi方法。 此参数为零 (0) 的值将导致调用ConnectServerWmi返回才建立到服务器的连接。 这可能导致应用程序未响应无限期地服务器已中断。 其他有效值为:
| 返回的常量 | 值 | 描述 |
|---|---|---|
CONNECT_REPOSITORY_ONLY |
0x40 | 保留以供内部使用。 请勿使用。 |
WBEM_FLAG_CONNECT_USE_MAX_WAIT |
0x80 | ConnectServerWmi 返回在两分钟或更少。 |
strAuthority
[in]用户的域名。 可以有下列值:
| 值 | 描述 |
|---|---|
| 空白 | 使用 NTLM 身份验证,并使用当前用户的 NTLM 域。 如果strUser指定域 (推荐位置),它必须未在此处指定。 该函数将返回WBEM_E_INVALID_PARAMETER如果两个参数中指定的域。 |
| Kerberos:主体名称 | 使用 Kerberos 身份验证,并且此参数包含 Kerberos 主体名称。 |
| NTLMDOMAIN:域名 | 使用 NT LAN Manager 身份验证,并且此参数包含的 NTLM 域名。 |
pCtx
[in]通常情况下,此参数是null。 否则,它是一个指向IWbemContext对象所需的一个或多个动态类提供程序。
ppNamespace
[out]当函数返回时,接收一个指向IWbemServices对象绑定到指定的命名空间。 它设置为指向null时出现错误。
impLevel
[in]模拟级别。
authLevel
[in]授权级别。
返回值
此函数返回以下值中定义WbemCli.h标头文件,也可以在定义它们为常量在代码中:
| 返回的常量 | 值 | 描述 |
|---|---|---|
WBEM_E_FAILED |
0x80041001 | 已存在时的常见错误。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 参数不是有效的。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 没有足够的内存是可用于完成该操作。 |
WBEM_S_NO_ERROR |
0 | 函数调用成功。 |
备注
此函数包装对的调用IWbemLocator::ConnectServer方法。
为本地访问默认命名空间strNetworkResource可以是简单的对象路径:"root\default"或"\.\root\default"。 用于访问远程计算机上的默认命名空间使用 COM 或 Microsoft 兼容的网络,包含计算机名称:"\myserver\root\default"。 计算机名称也可以是 DNS 名称或 IP 地址。 ConnectServerWmi函数还可以连接运行 IPv6 的计算机使用 IPv6 地址。
strUser 不能为空字符串。 如果在指定了域strAuthority,它不还必须包含在strUser,或该函数将返回WBEM_E_INVALID_PARAMETER。
要求
平台: 请参阅系统需求。
标头: WMINet_Utils.idl
**.NET Framework 版本:**自 4.7.2 之后可用
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpetrusha)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
