WSMAN_PLUGIN_REQUEST 구조체(wsman.h)

  • 아티클

플러그 인 요청에 대한 정보를 지정합니다. WSMAN_PLUGIN_REQUEST 구조체에 대한 포인터는 플러그 인 내의 모든 작업 진입점에 전달됩니다. 모든 결과 알림 메서드는 이 포인터를 사용하여 결과를 요청과 일치합니다. 플러그 인이 작업에서 WSManPluginOperationComplete 를 호출할 때까지 구조체의 모든 정보는 유효한 상태로 유지됩니다.

구문

typedef struct _WSMAN_PLUGIN_REQUEST {
  WSMAN_SENDER_DETAILS *senderDetails;
  PCWSTR               locale;
  PCWSTR               resourceUri;
  WSMAN_OPERATION_INFO *operationInfo;
  BOOL                 shutdownNotification;
  HANDLE               shutdownNotificationHandle;
  PCWSTR               dataLocale;
} WSMAN_PLUGIN_REQUEST;

멤버

senderDetails

요청을 시작한 클라이언트에 대한 세부 정보를 지정하는 WSMAN_SENDER_DETAILS 구조체에 대한 포인터입니다.

locale

사용자가 결과를 요청한 로캘을 지정합니다. 요청된 로캘을 사용할 수 없는 경우 다음 옵션을 사용할 수 있습니다.

  • 시스템 로캘이 사용됩니다.
  • 잘못된 로캘 오류로 요청이 거부됩니다.
플러그 인을 호출하면 스레드의 로캘이 이 멤버에 지정된 로캘로 설정됩니다. 플러그 인에 요청에 대해 작업하는 다른 스레드가 있는 경우 플러그 인은 사용하는 각 스레드에 따라 로캘을 설정해야 합니다.

resourceUri

이 작업의 리소스 URI 를 지정합니다.

operationInfo

작업에 대한 추가 정보가 포함된 WSMAN_OPERATION_INFO 구조체에 대한 포인터입니다. 모든 매개 변수가 모든 작업과 관련이 있는 것은 아니므로 이 구조의 일부 정보는 NULL 이 됩니다.

shutdownNotification

작업이 취소되면 shutdownNotification 멤버가 TRUE로 설정됩니다.

shutdownNotificationHandle

작업이 취소되면 shutdownNotification 이 신호를 보냅니다.

dataLocale

설명

작업은 작업이 종료되었음을 나타내기 위해 작업에 대한 콜백 신호를 보내야 합니다. 최상위 작업 전에 모든 후속 작업이 취소되도록 계층적 방식으로 작업이 취소됩니다. 플러그 인에는 작업의 취소를 처리하는 두 가지 방법이 있습니다. 먼저 플러그 인은 결과 집합을 반복하는 경우 shutdownNotification 부울 값을 검사 수 있습니다. 둘째, 플러그 인이 본질적으로 더 비동기적이면 비동기 알림 스레드를 큐에 대기할 때 shutdownNotificationHandle 을 사용할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7
지원되는 최소 서버 Windows Server 2008 R2
머리글 wsman.h
재배포 가능 파일 WINDOWS Server 2008 SP2, WINDOWS Vista SP1 및 Windows Vista sp2의 Windows Management Framework