勇芳软件工作室.汉化:  Windows Management Instrumentation > COM API for WMI > Interfaces > IWbemPath >

GetServer Method

Previous pageReturn to chapter overviewNext page

描述

 

IWbemPath.GetServer方法检索路径的服务器部分。

 

C++ 语法

 

HRESULT GetServer(

[in, out]  ULONG *puNameBufLength,

[in, out]  LPWSTR pszName

);

 

PowerBASIC 语法

 

METHOD GetServer ( _

BYREF puNameBufLength AS DWORD, _

BYREF pszName AS WSTRINGZ _

) AS LONG

 

参数

 

puNameBufLength

 

一旦输入,这是由pszName指向的缓冲区的字符大小。返回时,这是服务器名称中的字符数,包括NULL终止符。

 

pszName

 

服务器名称。

 

返回值

 

此方法返回以下值之一。

 

退货代码

描述

S_OK

方法成功执行

WBEM_E_BUFFER_TOO_SMALL

由pszName指向的缓冲区太小。

WBEM_E_INVALID_PARAMETER

puNameBufLength参数为NULL或当pszName为NULL时指示缓冲区大小。

WBEM_E_NOT_AVAILABLE

服务器为NULL。

WBEM_E_OUT_OF_MEMORY

内存不足以执行此方法。

 

备注

 

该方法可用于确定pszName需要多大的缓冲区。这是通过传递缓冲区的NULL指针,将puNameBufLength设置为0(零),然后进行调用。返回时,puNameBufLength指示pszName及其终止NULL字符需要多大的缓冲区。

 

Windows 2000 / NT:需要WMI SDK Update或Microsoft .NET Framework SDK。

 

Windows NT:需要Microsoft .NET Framework SDK。

 

要求

 

客户

需要Windows Vista或Windows XP。

服务器

需要Windows Server 2008或Windows Server 2003。

可再发行

需要Windows 2000和Windows NT上的WMI可重新分发组件版本1.0。在Windows NT上,它也需要Microsoft .NET Framework。

在Wmiutils.inc中声明。

DLL

需要Wmiutils.dll。