Поделиться через


Метод IWbemPath::GetNamespaceAt (wmiutils.h)

Метод IWbemPath::GetNamespaceAt извлекает пространство имен на основе его индекса. Крайнее левое пространство имен в пути имеет индекс 0, при этом каждое пространство имен перемещается вправо с постепенно более высоким значением индекса.

Синтаксис

HRESULT GetNamespaceAt(
  [in]      ULONG  uIndex,
  [in, out] ULONG  *puNameBufLength,
  [in, out] LPWSTR pName
);

Параметры

[in] uIndex

Индекс считываемого пространства имен. Крайнее левое пространство имен в пути — индекс 0, при этом каждое пространство имен справа имеет постепенно более высокое значение индекса. Максимально допустимое значение на один меньше текущего числа пространств имен.

[in, out] puNameBufLength

Вызывающий объект задает для параметра количество символов, которые может содержать буфер. После успешного выполнения устанавливается количество символов, скопированных в буфер, включая признак конца NULL .

[in, out] pName

Имя пространства имен.

Возвращаемое значение

Этот метод возвращает HRESULT , указывающий состояние вызова метода.

Комментарии

Этот метод можно использовать для определения размера буфера, необходимого для pName. Это делается путем передачи указателя NULL для буфера, установки puNameBufLength значения 0, а затем выполнения вызова. После возврата puNameBufLength указывает, насколько большой размер буфера требуется для pName и его завершающий символ NULL .

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header wmiutils.h
Библиотека Wbemuuid.lib
DLL Wmiutils.dll

См. также раздел

IWbemPath