WSManConnectShell 함수(wsman.h)

기존 서버 세션에 연결합니다.

구문

void WSManConnectShell(
  [in, out]      WSMAN_SESSION_HANDLE session,
                 DWORD                flags,
  [in]           PCWSTR               resourceUri,
  [in]           PCWSTR               shellID,
  [in, optional] WSMAN_OPTION_SET     *options,
  [in, optional] WSMAN_DATA           *connectXml,
  [in]           WSMAN_SHELL_ASYNC    *async,
  [out]          WSMAN_SHELL_HANDLE   *shell
);

매개 변수

[in, out] session

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

flags

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

[in] resourceUri

연결이 만들어질 셸 유형을 정의합니다. 셸 형식은 고유한 URI에 의해 정의되므로 호출에서 반환된 셸 개체는 이 매개 변수로 지정된 URI에 따라 달라집니다. resourceUri 매개 변수는 NULL일 수 없으며 null로 끝나는 문자열입니다.

[in] shellID

클라이언트가 연결하려는 서버 셸 세션과 연결된 셸 식별자를 지정합니다.

[in, optional] options

셸에 대한 옵션 집합을 지정하는 WSMAN_OPTION_SET 구조체에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

[in, optional] connectXml

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

[in] async

선택적 사용자 컨텍스트 및 필수 콜백 함수를 포함하는 비동기 구조를 정의합니다. 자세한 내용은 WSMAN_SHELL_ASYNC 구조를 참조하세요. 이 매개 변수는 NULL일 수 없습니다.

[out] shell

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

반환 값

없음

설명

ShellId 매개 변수로 식별된 기존 서버 셸 세션에 연결합니다. 이렇게 하면 명령 실행, 서버 셸 세션에서 출력 보내기 및 수신과 같은 후속 작업을 수행하는 데 사용할 수 있는 반환 매개 변수 셸로 표현되는 필요한 클라이언트 쪽 컨텍스트가 빌드됩니다. 이 WSManConnectShell 함수는 현재 서버 셸 세션과 연결된 명령에 대한 클라이언트 쪽 컨텍스트를 자동으로 생성하지 않습니다.

요구 사항