WSManPluginGetOperationParameters 함수(wsman.h)

아티클
03/09/2024

작업과 연결된 제한 시간 및 데이터 제한과 같은 항목에 대한 운영 정보를 가져옵니다. 플러그 인은 정보 이외의 용도로 이러한 매개 변수를 사용하면 안 됩니다.

구문

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

매개 변수

[in] requestDetails

요청에 대한 리소스 URI, 옵션, 로캘, 종료 플래그 및 핸들을 지정하는 WSMAN_PLUGIN_REQUEST 구조체에 대한 포인터입니다.

[in] flags

검색에 사용할 수 있는 옵션을 지정합니다. 이 매개 변수는 다음 값 중 하나 또는 플러그 인에서 정의한 값으로 설정해야 합니다.

WSMAN_PLUGIN_PARAMS_MAX_ENVELOPE_SIZE (1)

작업 응답 패킷의 최대 크기를 지정합니다. 크기에는 SOAP(Simple Object Access Protocol) 오버헤드와 함께 데이터의 크기가 포함됩니다.

참고 일부 작업에는 여러 라운드트립이 발생할 수 있는 플러그 인에 대한 단일 호출이 있습니다. 이 메서드를 호출할 때 데이터를 기다리는 요청이 없으면 이전 패킷의 최대 봉투 크기가 지정됩니다.

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
헤더	wsman.h
라이브러리	WsmSvc.lib
DLL	WsmSvc.dll
재배포 가능 파일	SP2가 있는 Windows Server 2008 및 WINDOWS Vista SP2의 Windows Management Framework

다음을 통해 공유