Метод Provider::Commit (provider.h)

  • Статья

[Класс Provider является частью платформы поставщика WMI, которая в настоящее время рассматривается в окончательном состоянии, и дальнейшие разработки, улучшения или обновления не будут доступны для проблем, не связанных с безопасностью, влияющих на эти библиотеки. API mi mi следует использовать для всех новых разработок.]

Метод Commit используется для отправки экземпляра в WMI. Этот метод является вспомогательной функцией и не должен быть переопределен.

Синтаксис

HRESULT Commit(
  CInstance *pInstance,
  bool      bCache
);

Параметры

pInstance

Указатель на экземпляр, хранимый WMI.

bCache

Указывает, реализован ли кэш. Это значение должно быть равно FALSE в текущей версии платформы поставщика.

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

Используйте макросы SUCCEEDED или FAILED в возвращенном HRESULT, чтобы определить, был ли метод успешным.

Комментарии

Если клиент отменяет запрос, метод Commit возвращает ошибку. Модуль записи поставщика может использовать этот факт для завершения перечисления.

Кроме того, этот метод вызывает CInstance::Release в указателе pInstance . Поэтому поставщик платформы должен быть осторожным, чтобы не вызывать CInstance::Release снова. Это означает, что интеллектуальный указатель pInstance несовместим с этим методом, так как интеллектуальный указатель вызывает CInstance::Release в своем деструкторе.

Этот метод следует использовать только в том случае, если поставщик платформы не вызывает CInstance::Release в указателе pInstance отдельно и если указатель pInstance не является и никогда не будет интеллектуальным указателем.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header provider.h (включая FwCommon.h)
Библиотека FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll