WSManCreateSession 함수(wsman.h)

세션 개체를 만듭니다.

구문

DWORD WSManCreateSession(
  [in]           WSMAN_API_HANDLE                 apiHandle,
  [in, optional] PCWSTR                           connection,
                 DWORD                            flags,
  [in, optional] WSMAN_AUTHENTICATION_CREDENTIALS *serverAuthenticationCredentials,
  [in, optional] WSMAN_PROXY_INFO                 *proxyInfo,
  [out]          WSMAN_SESSION_HANDLE             *session
);

매개 변수

[in] apiHandle

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

[in, optional] connection

연결할 프로토콜 및 에이전트를 나타냅니다. 이 매개 변수가 NULL인 경우 연결은 기본적으로 localhost(127.0.0.1)로 설정됩니다. 이 매개 변수는 간단한 호스트 이름 또는 전체 URL일 수 있습니다. 형식은 다음과 같습니다.

[transport://]host[:p ort][/접두사] 위치:

요소	Description
교통	HTTP 또는 HTTPS 중 하나. 기본값은 HTTP입니다.
host	DNS 이름, NetBIOS 이름 또는 IP 주소에 있을 수 있습니다.
포트	기본값은 HTTP의 경우 80이고 HTTPS의 경우 443으로 설정됩니다. 기본값은 로컬 구성에서 변경할 수 있습니다.
접두사	모든 문자열. 기본값은 "wsman"입니다. 로컬 구성에서 기본값을 변경할 수 있습니다.

flags

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

[in, optional] serverAuthenticationCredentials

Negotiate, Kerberos, Digest, Basic 또는 클라이언트 인증서와 같은 인증 방법을 정의합니다. 인증 메커니즘이 Negotiate, Kerberos, Digest 또는 Basic인 경우 구조에는 인증에 사용되는 자격 증명도 포함될 수 있습니다. 클라이언트 인증서 인증을 사용하는 경우 인증서 지문을 지정해야 합니다.

자격 증명이 지정된 경우 이 매개 변수에는 로컬 계정 또는 도메인 계정의 사용자 이름과 암호가 포함됩니다. 이 매개 변수가 NULL이면 기본 자격 증명이 사용됩니다. 기본 자격 증명은 현재 스레드가 실행 중인 자격 증명입니다. 기본 또는 다이제스트 인증을 사용할 때 클라이언트는 자격 증명을 명시적으로 지정해야 합니다. 명시적 자격 증명을 사용하는 경우 사용자 이름과 암호가 모두 유효해야 합니다. 인증 자격 증명에 대한 자세한 내용은 WSMAN_AUTHENTICATION_CREDENTIALS 구조를 참조하세요.

[in, optional] proxyInfo

프록시 정보를 지정하는 WSMAN_PROXY_INFO 구조체에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.

[out] session

세션을 고유하게 식별하는 세션 핸들을 정의합니다. 이 매개 변수는 NULL일 수 없습니다. WSManCloseSession 메서드를 호출하여 이 핸들을 닫아야 합니다.

반환 값

함수가 성공할 경우 반환 값은 0입니다. 그렇지 않으면 반환 값이 오류 코드입니다.

요구 사항

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