다음을 통해 공유


WSManSetSessionOption 함수(wsman.h)

세션에 대한 확장 옵션 집합을 설정합니다.

구문

DWORD WSManSetSessionOption(
  [in] WSMAN_SESSION_HANDLE session,
       WSManSessionOption   option,
  [in] WSMAN_DATA           *data
);

매개 변수

[in] session

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

option

설정할 옵션을 지정합니다. 이 매개 변수는 WSManSessionOption 열거형의 값 중 하나로 설정해야 합니다.

[in] data

옵션 값을 정의하는 WSMAN_DATA 구조체에 대한 포인터입니다.

반환 값

이 메서드는 성공에 대해 0을 반환합니다. 그렇지 않으면 이 메서드는 오류 코드를 반환합니다.

설명

옵션 매개 변수에 대해 지정된 다른 값으로 WSManSetSessionOption 메서드를 호출하는 경우 다른 옵션의 순서가 중요합니다. WSManSetSessionOption이 처음 호출되면 세션에 대한 전송이 설정됩니다. 두 번째 호출이 다른 유형의 전송을 요청하면 호출이 실패합니다.

예를 들어 메서드가 다음 순서로 호출되면 두 번째 메서드 호출이 실패합니다.

  • WSManSetSessionOption(WSMAN_OPTION_UNENCRYPTED_MESSAGES)
  • WSManSetSessionOption(WSMAN_OPTION_ALLOW_NEGOTIATE_IMPLICIT_CREDENTIALS)
옵션 매개 변수가 WSMAN_OPTION_UNENCRYPTED_MESSAGES 설정되므로 첫 번째 메서드 호출은 전송을 HTTP로 설정합니다. 전달된 옵션이 HTTPS에 적용 가능하고 전송이 첫 번째 메시지에 의해 HTTP로 설정되었기 때문에 두 번째 호출이 실패합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 7
지원되는 최소 서버 Windows Server 2008 R2
대상 플랫폼 Windows
헤더 wsman.h
라이브러리 WsmSvc.lib
DLL WsmSvc.dll
재배포 가능 파일 WINDOWS Server 2008 SP2, WINDOWS Vista SP1 및 Windows Vista sp2의 Windows Management Framework