大网数据广告活动
.NET 与 C# 开发

ConnectServerWmi 函数 (非托管 API 参考)

· 52CE 我爱测

ConnectServerWmi 函数使用 DCOM 来创建与 WMI 命名空间的连接。

通过 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,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 11/06/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。