Метод IWbemCallResult::GetResultString (wbemcli.h)

Статья
03/09/2024

Метод IWbemCallResult::GetResultString возвращает путь к назначенному объекту экземпляра, созданного IWbemServices::P utInstance.

Примечание Объект результата вызова в основном используется, когда вызов PutInstance выполняется поставщиком и клиент должен знать путь к объекту (значения свойств ключа), назначенный поставщику. Например, если свойство ключа класса является глобально уникальным идентификатором (GUID), назначенным поставщиком во время операции PutInstance , клиент не сможет узнать этот GUID, если поставщик не сможет вернуть его таким образом.

Синтаксис

HRESULT GetResultString(
  [in]  long lTimeout,
  [out] BSTR *pstrResultString
);

Параметры

[in] lTimeout

Указывает максимальное время в миллисекундах, которое этот вызов блокирует перед возвратом. Если вы используете константную WBEM_INFINITE (0xFFFFFFFF), вызов блокируется до тех пор, пока путь к объекту не будет доступен. При использовании 0 вызов немедленно возвращает путь к объекту или код состояния.

[out] pstrResultString

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

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

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

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

Коды ошибок COM также могут быть возвращены, если проблемы с сетью приводят к потере удаленного подключения к управлению Windows.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)

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

IWbemCallResult

IWbemServices::P utInstance

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