Метод IWSManSession::Create (wsmandisp.h)
Создает новый экземпляр ресурса и возвращает ссылку на конечную точку (EPR) нового объекта.
Синтаксис
HRESULT Create(
[in] VARIANT resourceUri,
[in] BSTR resource,
[in] long flags,
[out] BSTR *newUri
);
Параметры
[in] resourceUri
Идентификатор создаваемого ресурса.
Этот параметр может содержать одно из следующих значений:
- URI с одним или несколькими селекторами. Имейте в виду, что подключаемый модуль WMI не поддерживает создание ресурсов, отличных от прослушивателя протокола WS-Management.
- Объект ResourceLocator, который может содержать селекторы, фрагменты или параметры.
- Справочник по конечной точке WS-Addressing, как описано в стандарте протокола WS-Management. Дополнительные сведения об общедоступной спецификации протокола WS-Management см. на странице индекса спецификаций управления.
[in] resource
Строка XML, содержащая содержимое ресурса.
[in] flags
Зарезервировано. Должен иметь значение 0.
[out] newUri
EPR нового ресурса.
Возвращаемое значение
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
IWSManSession::Create используется только для создания новых экземпляров ресурса. Используйте метод IWSManSession::P ut для обновления существующих экземпляров ресурса. Получив URI нового ресурса, можно вызвать IWSManSession::Get , чтобы получить новый объект . Новый объект содержит все свойства, присваиваемые поставщиком ресурсов при создании нового объекта. Например, если создать новыйпрослушиватель протокола WS-Management и получить объект прослушивателя с помощью Session.Get, вы также получите свойства Port, Enabled и ListeningOn .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wsmandisp.h |
| Библиотека | WSManDisp.tlb |
| DLL | WSMAuto.dll |