SWbemServices.ReferencesTo 메서드
SWbemServices 개체의 ReferencesTo 메서드는 특정 원본 클래스 또는 인스턴스를 참조하는 모든 연관 클래스 또는 인스턴스의 컬렉션을 반환합니다. 이 메서드는 REFERENCES OF WQL 쿼리가 수행하는 것과 동일한 함수를 수행합니다.
이 메서드는 반동기 모드에서 호출됩니다. 자세한 내용은 메서드 호출을 참조하세요.
이 구문에 대한 설명은 스크립팅 API의 문서 규칙을 참조하세요.
구문
objWbemObjectSet = .ReferencesTo( _
ByVal strObjectPath, _
[ ByVal strResultClass ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ] _
)
매개 변수
-
strObjectPath
-
필수 요소. 이 메서드에 대한 원본의 개체 경로를 포함하는 문자열입니다. 자세한 내용은 WMI 개체의 위치 설명을 참조하세요.
-
strResultClass [선택 사항]
-
클래스 이름을 포함하는 문자열입니다. 지정된 경우 이 매개 변수는 반환된 연결 개체가 이 매개 변수에 지정된 클래스에 속하거나 이 클래스에서 파생되어야 함을 나타냅니다.
-
strRole [optional]
-
속성 이름을 포함하는 문자열입니다. 지정된 경우 이 매개 변수는 반환된 연결 개체가 원본 개체가 특정 역할을 수행하는 개체로 제한되어야 함을 나타냅니다. 역할은 연결의 지정된 속성(참조 속성이어야 함)의 이름으로 정의됩니다.
-
bClassesOnly [optional]
-
클래스의 실제 인스턴스가 아닌 클래스 이름 목록을 반환해야 하는지 여부를 나타내는 부울 값입니다. 연결 개체가 속한 클래스입니다. 이 매개 변수의 기본값은 FALSE입니다.
-
bSchemaOnly [optional]
-
쿼리가 데이터가 아닌 스키마에 적용되는지 여부를 나타내는 부울 값입니다. 이 매개 변수의 기본값은 FALSE입니다. strObjectPath 매개 변수가 클래스의 개체 경로를 지정하는 경우에만 TRUE로 설정할 수 있습니다. TRUE로 설정하면 반환된 엔드포인트 집합이 스키마의 원본 클래스와 적절하게 연결된 클래스를 나타냅니다.
-
strRequiredQualifier [선택 사항]
-
한정자 이름을 포함하는 문자열입니다. 지정된 경우 이 매개 변수는 반환된 연결 개체에 지정된 한정자를 포함해야 함을 나타냅니다.
-
iFlags [선택 사항]
-
작업에 대한 추가 플래그를 지정하는 정수입니다. 이 매개 변수의 기본값은 wbemFlagReturnImmediately이며 쿼리가 완료될 때까지 기다리지 않고 즉시 반환되도록 호출을 지시합니다. 이 매개 변수는 다음 값을 허용할 수 있습니다.
-
wbemFlagForwardOnly(32(0x20))
-
정방향 전용 열거자가 반환되도록 합니다. 정방향 전용 열거자는 일반적으로 기존 열거자보다 훨씬 빠르고 메모리를 덜 사용하지만 SWbemObject.Clone_에 대한 호출을 허용하지 않습니다.
-
wbemFlagBidirectional(0(0x0))
-
클라이언트가 열거자를 해제할 때까지 WMI(Windows Management Instrumentation)가 열거형 개체에 대한 포인터를 유지하도록 합니다.
-
wbemFlagReturnImmediately(16(0x10))
-
호출이 즉시 반환되도록 합니다.
-
wbemFlagReturnWhenComplete(0(0x0))
-
쿼리가 완료될 때까지 이 호출을 차단합니다. 이 플래그는 동기 모드에서 메서드를 호출합니다.
-
wbemFlagUseAmendedQualifiers(131072(0x20000))
-
WMI가 기본 클래스 정의와 함께 클래스 수정 데이터를 반환하도록 합니다. 자세한 내용은 WMI 클래스 정보 지역화를 참조하세요.
objWbemNamedValueSet [optional]
일반적으로 이는 정의되지 않습니다. 그렇지 않으면 요청을 서비스하는 공급자가 사용할 수 있는 컨텍스트 정보를 나타내는 요소가 있는 SWbemNamedValueSet 개체입니다. 그러한 정보를 지원하거나 요구하는 공급자는 인식된 값 이름, 값의 데이터 형식, 허용된 값 및 의미 체계를 문서화해야 합니다.
반환 값
메서드가 성공하면 메서드는 SWbemObjectSet 개체를 반환합니다.
오류 코드
ReferencesTo 메서드 완료 후 Err 개체에는 다음 목록에 있는 오류 코드 중 하나가 포함될 수 있습니다.
참고
0 요소가 있는 반환된 컬렉션은 오류가 아닙니다.
-
wbemErrAccessDenied - 2147749891(0x80041003)
-
현재 사용자는 호출에서 반환된 하나 이상의 클래스를 볼 수 있는 권한이 없습니다.
-
wbemErrFailed - 2147749889(0x80041001)
-
알 수 없는 오류입니다.
-
wbemErrInvalidParameter - 2147749896(0x80041008)
-
잘못된 매개 변수가 지정되었습니다.
-
wbemErrOutOfMemory - 2147749894(0x80041006)
-
메모리가 부족하여 작업을 완료할 수 없습니다.
-
wbemFlagUseAmendedQualifiers - 131072(0x20000)
-
WMI가 기본 클래스 정의와 함께 클래스 수정 데이터를 반환하도록 합니다.
설명
REFERENCES OF 연결된 WQL 쿼리, 원본 인스턴스 및 연결 개체에 대한 자세한 내용은 ASSOCIATORS OF 문을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista |
| 지원되는 최소 서버 |
Windows Server 2008 |
| 헤더 |
|
| 유형 라이브러리 |
|
| DLL |
|
| CLSID |
CLSID_SWbemServices |
| IID |
IID_ISWbemServices |