SWbemServices.Get 메서드

SWbemServices 개체의 Get 메서드는 개체 경로를 기준으로 클래스 정의 또는 인스턴스인 개체를 검색합니다. 이 메서드는 현재 SWbemServices 개체와 연결된 네임스페이스에서 개체만 검색합니다.

이 메서드는 동기 모드에서 호출됩니다. 자세한 내용은 메서드 호출을 참조하세요.

이 구문에 대한 설명은 스크립팅 API의 문서 규칙을 참조하세요.

구문

objWbemObject = .Get( _
  [ ByVal strObjectPath ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

매개 변수

strObjectPath [선택 사항]

검색할 개체의 개체 경로가 들어 있는 문자열입니다. 이 값이 비어 있으면 반환되는 빈 개체가 새 클래스가 될 수 있습니다. 자세한 내용은 WMI 개체의 위치 설명을 참조하세요.

iFlags [선택 사항]

쿼리의 동작을 결정하는 정수입니다. 이 매개 변수는 다음 값을 허용할 수 있습니다.

wbemFlagUseAmendedQualifiers(131072 (0x20000))

WMI가 기본 클래스 정의와 함께 클래스 수정 데이터를 반환하도록 합니다. 수정된 한정자에 대한 자세한 내용은 WMI 클래스 정보 지역화를 참조하세요.

objWbemNamedValueSet [optional]

일반적으로 이는 정의되지 않습니다. 그렇지 않으면 요청을 서비스하는 공급자가 사용할 수 있는 컨텍스트 정보를 나타내는 요소가 있는 SWbemNamedValueSet 개체입니다. 그러한 정보를 지원하거나 요구하는 공급자는 인식된 값 이름, 값의 데이터 형식, 허용된 값 및 의미 체계를 문서화해야 합니다.

반환 값

성공하면 이 메서드는 요청된 개체를 나타내는 SWbemObject 개체를 반환합니다.

오류 코드

Get 메서드가 완료되면 Err 개체에 다음 목록의 오류 코드 중 하나가 포함될 수 있습니다.

wbemErrAccessDenied - 2147749891(0x80041003)

현재 사용자에게 개체에 액세스할 수 있는 권한이 없습니다.

wbemErrFailed - 2147749889(0x80041001)

알 수 없는 오류입니다.

wbemErrInvalidParameter - 2147749896(0x80041008)

지정된 매개 변수가 유효하지 않습니다.

wbemErrInvalidObjectPath - 2147749946(0x8004103A)

지정된 경로가 유효하지 않습니다.

wbemErrNotFound - 2147749890(0x80041002)

요청된 개체를 찾을 수 없습니다.

wbemErrOutOfMemory - 2147749894(0x80041006)

메모리가 부족하여 작업을 완료할 수 없습니다.

설명

ExecQuery 및 InstancesOf 메서드와 달리 Get 메서드는 항상 WMI 관리 리소스의 특정 인스턴스를 나타내는 SWbemObject를 반환합니다. Get 메서드를 사용하여 WMI 관리 리소스의 특정 인스턴스를 가져오려면 다음 스크립트와 같이 메서드를 개체 경로에 전달하여 검색하도록 인스턴스 가져오기를 지시해야 합니다.

strComputer = "."
Set objSWbemServices = GetObject("winmgmts:\\" & strComputer & "\root\cimv2")
Set objSWbemObject = objSWbemServices.Get("Win32_Service.Name='Messenger'")
Wscript.Echo "Name:         " & objSWbemObject.Name        & vbCrLf & _
             "Display Name: " & objSWbemObject.DisplayName & vbCrLf & _
             "Start Mode:   " & objSWbemObject.StartMode   & vbCrLf & _
             "State:        " & objSWbemObject.State

이 메서드를 사용하여 __CIMOMIdentification 같은 단일 항목 개체를 가져올 수 있으며, 여기에는 실행 중인 WMI 설치에 대한 버전 정보가 포함됩니다.

CIM Studio와 같은 보기 도구로 리포지토리를 검사하여 새 클래스와 인스턴스가 나타나는지 확인할 수 있습니다. 리포지토리에서 클래스 및 인스턴스를 제거하는 예제는 SWbemServices.Delete 또는 SWbemObject.Delete_를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
헤더	Wbemdisp.h
유형 라이브러리	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemServices
IID	IID_ISWbemServices

추가 정보

SWbemServices

SWbemObject