WSManRunShellCommandEx 함수(wsman.h)

명령 ID 옵션을 추가하여 WSManRunShellCommand 함수와 동일한 기능을 제공합니다. 서버가 프로토콜을 지원하는 경우 클라이언트에서 지정한 ID를 사용하여 명령 instance 만듭니다. 지정된 ID가 있는 명령이 이미 있는 경우 서버는 instance 명령을 만들지 못합니다. 이 새로운 기능은 클라이언트 애플리케이션이 WSManInitialize 함수 호출의 일부로 WSMAN_FLAG_REQUESTED_API_VERSION_1_1 플래그를 전달하는 경우에만 사용할 수 있습니다.

구문

void WSManRunShellCommandEx(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandId,
  [in]           PCWSTR                commandLine,
  [in, optional] WSMAN_COMMAND_ARG_SET *args,
  [in, optional] WSMAN_OPTION_SET      *options,
  [in]           WSMAN_SHELL_ASYNC     *async,
  [out]          WSMAN_COMMAND_HANDLE  *command
);

매개 변수

[in, out] shell

WSManCreateShell 호출에서 반환되는 셸 핸들을 지정합니다. 이 매개 변수는 NULL일 수 없습니다.

flags

다음에 사용하도록 예약됩니다. 0이어야 합니다.

[in] commandId

클라이언트가 지정한 명령 ID입니다.

[in] commandLine

실행할 명령을 나타내는 필수 null로 끝나는 문자열을 정의합니다. 일반적으로 명령은 별도로 지정된 인수 없이 지정됩니다. 그러나 사용자는 이 매개 변수를 사용하여 명령줄과 모든 인수를 지정할 수 있습니다. commandLine 매개 변수에 인수를 지정하는 경우 args 매개 변수는 NULL이어야 합니다.

[in, optional] args

생성할 때 명령에 전달되는 인수 값 배열을 정의하는 WSMAN_COMMAND_ARG_SET 구조체에 대한 포인터입니다. 인수가 필요하지 않은 경우 이 매개 변수는 NULL이어야 합니다.

[in, optional] options

명령에 대한 옵션 집합을 정의합니다. 이러한 옵션은 명령 실행을 수정하거나 구체화하기 위해 서비스에 전달됩니다. 이 매개 변수는 NULL일 수 있습니다. 옵션에 대한 자세한 내용은 WSMAN_OPTION_SET 참조하세요.

[in] async

비동기 구조를 정의합니다. 비동기 구조에는 선택적 사용자 컨텍스트 및 필수 콜백 함수가 포함됩니다. 자세한 내용은 WSMAN_SHELL_ASYNC 구조를 참조하세요. 이 매개 변수는 NULL 일 수 없으며 WSManCloseCommand 메서드를 호출하여 닫아야 합니다.

[out] command

셸 내의 명령과 연결된 명령 개체를 정의합니다. 이 핸들은 성공적인 호출에서 반환되며 데이터를 보내고 받고 명령을 신호하는 데 사용됩니다. WSManCloseCommand 메서드를 호출하여 이 핸들을 닫아야 합니다. 이 매개 변수는 NULL일 수 없습니다.

반환 값

없음

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	Windows
헤더	wsman.h
라이브러리	WsmSvc.lib
DLL	WsmSvc.dll