WSManRunShellCommand 함수(wsman.h)

기존 셸 내에서 명령 실행을 시작하고 명령이 완료될 때까지 기다리지 않습니다.

구문

void WSManRunShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [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] 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 7
지원되는 최소 서버	Windows Server 2008 R2
대상 플랫폼	Windows
헤더	wsman.h
라이브러리	WsmSvc.lib
DLL	WsmSvc.dll
재배포 가능 파일	SP2가 있는 Windows Server 2008 및 WINDOWS Vista SP2의 Windows Management Framework