Функция WSManPluginGetOperationParameters (wsman.h)

Статья
03/09/2024

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

Синтаксис

DWORD WSManPluginGetOperationParameters(
  [in]  WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]  DWORD                flags,
  [out] WSMAN_DATA           *data
);

Параметры

[in] requestDetails

Указатель на структуру WSMAN_PLUGIN_REQUEST , которая указывает URI ресурса, параметры, языковой стандарт, флаг завершения работы и дескриптор для запроса.

[in] flags

Указывает параметры, доступные для извлечения. Для этого параметра необходимо задать одно из следующих значений или значение, определенное подключаемым модулем.

WSMAN_PLUGIN_PARAMS_MAX_ENVELOPE_SIZE (1)

Указывает максимальный размер пакета ответа операции. Размер включает размер данных, а также затраты на протокол SOAP.

Примечание Некоторые операции имеют один вызов подключаемого модуля, который может вызвать несколько циклов. Если при вызове этого метода никакие запросы не ожидают данные, присваивается максимальный размер конверта для предыдущего пакета.

WSMAN_PLUGIN_PARAMS_TIMEOUT (2)

Указывает время ожидания текущей операции.

Примечание Некоторые операции имеют один вызов подключаемого модуля, который может вызвать несколько циклов. Если при вызове этого метода никакие запросы не ожидают данных, то для предыдущего пакета будет задано время ожидания.

WSMAN_PLUGIN_PARAMS_REMAINING_RESULT_SIZE (3)

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

Примечание Некоторые операции имеют один вызов подключаемого модуля, который может вызвать несколько циклов. Если при вызове этого метода никакие запросы не ожидают данных, для кэшированного элемента задается оставшийся размер.

WSMAN_PLUGIN_PARAMS_LARGEST_RESULT_SIZE (4)

Указывает максимальный размер данных для текущей операции.

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_LOCALE (5)

Указывает языковой стандарт, запрошенный клиентом для операции.

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_DATA_LOCALE (6)

Задает языковой стандарт данных, запрошенных клиентом.

[out] data

Указатель на структуру WSMAN_DATA , задающую результирующий объект.

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

При успешном выполнении метод возвращает NO_ERROR . в противном случае возвращается код ошибки. Ниже приведены наиболее распространенные коды ошибок.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7
Минимальная версия сервера	Windows Server 2008 R2
Целевая платформа	Windows
Header	wsman.h
Библиотека	WsmSvc.lib
DLL	WsmSvc.dll
Распространяемые компоненты	Windows Management Framework в Windows Server 2008 с пакетом обновления 2 (SP2) и Windows Vista с пакетом обновления 2 (SP2)

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