WSManCreateShell 함수(wsman.h)

셸 개체를 만듭니다. 반환된 셸 핸들은 명령을 실행할 수 있는 컨텍스트를 정의하는 개체를 식별합니다. 컨텍스트는 환경 변수, 입력 및 출력 스트림 및 작업 디렉터리에 의해 정의됩니다. 컨텍스트는 명령의 동작에 직접적인 영향을 줄 수 있습니다. 셸 컨텍스트는 연결 매개 변수로 지정된 원격 컴퓨터에 만들어지고 자격 증명 매개 변수를 사용하여 인증됩니다.

구문

void WSManCreateShell(
  [in, out]      WSMAN_SESSION_HANDLE     session,
                 DWORD                    flags,
  [in]           PCWSTR                   resourceUri,
  [in, optional] WSMAN_SHELL_STARTUP_INFO *startupInfo,
  [in, optional] WSMAN_OPTION_SET         *options,
  [in, optional] WSMAN_DATA               *createXml,
  [in]           WSMAN_SHELL_ASYNC        *async,
  [out]          WSMAN_SHELL_HANDLE       *shell
);

매개 변수

[in, out] session

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

flags

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

[in] resourceUri

만들 셸 형식을 정의합니다. 셸 형식은 고유한 URI로 정의됩니다. 호출에서 반환된 실제 셸 개체는 지정된 URI에 따라 달라집니다. 이 매개 변수는 NULL일 수 없습니다. Windows cmd.exe 셸을 만들려면 WSMAN_CMDSHELL_URI 리소스 URI를 사용합니다.

[in, optional] startupInfo

입력 및 출력 스트림, 작업 디렉터리, 유휴 시간 제한 및 셸에 대한 옵션을 지정하는 WSMAN_SHELL_STARTUP_INFO 구조체에 대한 포인터입니다.

이 매개 변수가 NULL이면 기본값이 사용됩니다.

[in, optional] options

셸에 대한 옵션 집합을 지정하는 WSMAN_OPTION_SET 구조체에 대한 포인터입니다.

[in, optional] createXml

셸에 대한 열린 컨텍스트를 정의하는 WSMAN_DATA 구조체에 대한 포인터입니다. 콘텐츠는 유효한 XML 문자열이어야 합니다. 이 매개 변수는 NULL일 수 있습니다.

[in] async

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

[out] shell

셸 개체를 고유하게 식별하는 셸 핸들을 정의합니다. 리소스 핸들은 셸에 대한 클라이언트 엔드포인트를 추적하는 데 사용되며 다른 WinRM 메서드에서 셸 개체와 상호 작용하는 데 사용됩니다. WSManCloseShell 메서드를 호출하여 셸 개체를 삭제해야 합니다. 이 매개 변수는 NULL일 수 없습니다.

반환 값

없음

요구 사항