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