MI_Application_NewSession 함수(mi.h)

단일 대상에 대한 작업 세트에 대한 연결을 공유하는 데 사용되는 세션을 만듭니다.

구문

MI_INLINE MI_Result MI_Application_NewSession(
  [in]           MI_Application        *application,
  [in, optional] const MI_Char         *protocol,
  [in, optional] const MI_Char         *destination,
  [in, optional] MI_DestinationOptions *options,
  [in, optional] MI_SessionCallbacks   *callbacks,
                 MI_Instance           **extendedError,
  [out]          MI_Session            *session
);

매개 변수

[in] application

MI_Application_Initialize 함수에서 반환된 핸들에 대한 포인터입니다.

[in, optional] protocol

작업을 수행하기 위한 선택적 프로토콜 처리기에 대한 포인터입니다. 이 매개 변수가 NULL이면 대상에 따라 기본값이 사용됩니다. 현재 지원되는 프로토콜은 L"WMIDCOM" 및 L"WINRM"입니다.

[in, optional] destination

세션에 대한 선택적 대상입니다. 대상 인수가 NULL이면 세션이 로컬 머신과 통신합니다. 그렇지 않으면 대상은 로컬 컴퓨터 또는 원격 컴퓨터의 컴퓨터 이름이 될 수 있습니다.

[in, optional] options

기본 시간 제한 및 자격 증명과 같은 선택적 대상 옵션에 대한 포인터입니다.

[in, optional] callbacks

다양한 결과를 수신하기 위한 콜백을 포함하는 선택적 MI_SessionCallbacks 구조체에 대한 포인터입니다.

extendedError

작업이 실패한 경우 선택적 추가 오류 정보에 대한 포인터입니다. 오류 정보 사용을 마쳤으면 MI_Instance_Delete 함수를 호출하여 메모리를 해제합니다.

[out] session

반환된 세션 핸들에 대한 포인터입니다. 세션 핸들 사용을 마치면 MI_Session_Close 함수를 호출하여 닫습니다. 애플리케이션과 애플리케이션 핸들을 모두 종료하기 전에 세션 핸들이 닫혀 있지 않으면 애플리케이션 핸들 종료가 응답하지 않습니다.

반환 값

이 함수는 MI_INLINE MI_Result 반환합니다.

설명

대상을 만들면 대상 컴퓨터와 통신할 수 없습니다. 애플리케이션이 컴퓨터에 액세스할 수 있는지 여부를 결정할 수 있는 세션에서 첫 번째 작업이 수행될 때까지는 수행되지 않습니다.

MI_Session_Close 함수는 아웃바운드 세션 핸들에서 호출되어야 합니다. 세션을 닫기 전에 대상 세션 아래의 모든 작업을 닫습니다.

프로토콜이 지정되지 않고 대상이NULL인 경우 WMIDCOM 프로토콜이 사용됩니다. 프로토콜이 지정되지 않고 대상이NULL이 아닌 경우 WINRM 프로토콜이 사용됩니다. .

요구 사항

추가 정보

Windows 원격 관리