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

Функция CloneEnumWbemClassObject

Создает логическую копию перечислителя, сохраняя текущую позицию в перечислении.

Примечание

Этот интерфейс API предназначен только для внутреннего использования. Он не предназначен для использования из кода разработчика.

Синтаксис

HRESULT CloneEnumWbemClassObject (
   [out] IEnumWbemClassObject**  ppEnum,
   [in] DWORD                    authLevel,
   [in] DWORD                    impLevel,
   [in] IEnumWbemClassObject*    pCurrentEnumWbemClassObject,
   [in] BSTR                     strUser,
   [in] BSTR                     strPassword,
   [in BSTR]                     strAuthority
);

Параметры

ppEnum
[out] Получает указатель на новый объект IEnumWbemClassObject.

authLevel
[in] Уровень авторизации.

impLevel
[in] Уровень олицетворения.

pCurrentEnumWbemClassObject
[out] Указатель на клонируемый экземпляр IEnumWbemClassObject .

strUser
[in] Имя пользователя. Дополнительные сведения см. в разделе Функция ConnectServerWmi .

strPassword
[in] Пароль. Дополнительные сведения см. в разделе Функция ConnectServerWmi .

strAuthority
[in] Доменное имя пользователя. Дополнительные сведения см. в разделе Функция ConnectServerWmi .

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

Следующие значения, возвращаемые этой функцией, определяются в файле заголовка WbemCli.h , или их можно определить как константы в коде:

Константа Значение Описание
WBEM_E_FAILED 0x80041001 Произошел общий сбой.
WBEM_E_INVALID_PARAMETER 0x80041008 Недопустимый параметр.
WBEM_E_OUT_OF_MEMORY 0x80041006 Недостаточно доступной памяти для завершения операции.
WBEM_E_TRANSPORT_FAILURE 0x80041015 Сбой связи удаленного вызова процедуры (RPC) между текущим процессом и WMI.
WBEM_S_NO_ERROR 0 Вызов функции выполнен успешно.

Комментарии

Эта функция создает оболочку для вызова метода IEnumWbemClassObject::Clone .

Этот метод создает только "наилучшее" копирование. Из-за динамической природы многих объектов CIM возможно, что новый перечислитель не перечисляет тот же набор объектов, что и перечислитель источника.

Если вызов функции завершается ошибкой, можно получить дополнительные сведения об ошибке, вызвав функцию GetErrorInfo .

Пример

Пример см. в описании метода IEnumWbemClassObject::Clone .

Требования

Платформы: см. раздел Требования к системе.

Заголовка: WMINet_Utils.idl

версии платформа .NET Framework: доступно с версии 4.7.2.

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

  • Last updated on