SWbemServices.AssociatorsOfAsync 메서드

아티클
06/13/2023

SWbemServices 개체의 AssociatorsOfAsync 메서드는 지정된 개체와 연결된 엔드포인트라는 개체(클래스 또는 인스턴스)의 컬렉션을 반환합니다. AssociatorsOfAsync에 대한 호출이 즉시 반환되고 결과와 상태는 objWbemSink에 지정된 싱크에 전달된 이벤트를 통해 호출자에게 반환됩니다. 반환된 각 개체를 처리하려면 objWbemSink.OnObjectReady 이벤트 처리기를 만듭니다.

모든 개체가 도착하면 objWbemSink.OnCompleted 이벤트에서 처리가 수행됩니다. 이 메서드는 ASSOCIATORS OF WQL 쿼리가 수행하는 것과 동일한 함수를 수행합니다. 싱크를 만드는 방법에 대한 자세한 내용은 WMI 이벤트 수신을 참조하세요.

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

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

구문

SWbemServices.AssociatorsOfAsync( _
  ByVal objWbemSink, _
  ByVal strObjectPath, _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

매개 변수

objWbemSink: 필수 요소. 개체를 비동기적으로 수신하는 개체 싱크입니다. 개체를 수신할 SWbemSink 개체를 만듭니다.
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]: 작업에 대한 추가 플래그를 지정하는 정수입니다. 이 매개 변수의 기본값은 wbemFlagDontSendStatus입니다. 이 매개 변수는 다음 값을 허용할 수 있습니다.
wbemFlagSendStatus (128 (0x80)): 비동기 호출이 개체 싱크에 대한 OnProgress 이벤트 처리기로 상태 업데이트를 보내도록 합니다.
wbemFlagDontSendStatus (0 (0x0)): 비동기 호출이 개체 싱크에 대한 OnProgress 이벤트 처리기로 상태 업데이트를 보내지 않도록 방지합니다.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): WMI가 기본 클래스 정의와 함께 클래스 수정 데이터를 반환하도록 합니다. 수정된 한정자에 대한 자세한 내용은 WMI 클래스 정보 지역화를 참조하세요.

objWbemNamedValueSet [optional]

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

objWbemAsyncContext [optional]

원래 비동기 호출의 원본을 식별하기 위해 개체 싱크로 반환되는 SWbemNamedValueSet 개체입니다. 동일한 개체 싱크를 사용하여 여러 비동기 호출을 수행하는 경우 이 매개 변수를 사용합니다. 이 매개 변수를 사용하려면 SWbemNamedValueSet 개체를 만들고 SWbemNamedValueSet.Add 메서드를 사용하여 수행 중인 비동기 호출을 식별하는 값을 추가합니다. 이 SWbemNamedValueSet 개체는 개체 싱크로 반환되며 SWbemNamedValueSet.Item 메서드를 사용하여 호출 원본을 추출할 수 있습니다. 자세한 내용은 메서드 호출을 참조하세요.

반환 값

이 메서드는 값을 반환하지 않습니다. 성공하면 싱크는 인스턴스당 OnObjectReady 이벤트를 수신합니다. 마지막 인스턴스 이후 개체 싱크는 OnCompleted 이벤트를 수신합니다.

오류 코드

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

wbemErrAccessDenied - 2147749891(0x80041003): 현재 사용자는 호출에서 반환된 하나 이상의 클래스를 볼 수 있는 권한이 없습니다.
wbemErrFailed - 2147749889(0x80041001): 알 수 없는 오류입니다.
wbemErrInvalidParameter - 2147749896(0x80041008): 잘못된 매개 변수가 지정되었습니다.
wbemErrOutOfMemory - 2147749894(0x80041006): 메모리가 부족하여 작업을 완료할 수 없습니다.
wbemErrNotFound - 2147749890(0x80041002): 요청한 항목을 찾을 수 없습니다.

설명

이 호출은 즉시 반환됩니다. 요청된 개체 및 상태는 objWbemSink에 지정된 싱크에 전달된 콜백을 통해 호출자에게 반환됩니다. 반환된 각 개체를 처리하려면 objWbemSink.OnObjectReady 이벤트 서브루틴을 만듭니다. 모든 개체가 반환되면 objWbemSink.OnCompleted 이벤트의 구현에서 최종 처리를 수행할 수 있습니다.

비동기 콜백을 사용하면 인증되지 않은 사용자가 싱크에 데이터를 제공할 수 있습니다. 이로 인해 스크립트 및 애플리케이션에 보안 위험이 발생할 수 있습니다. 위험을 제거하려면 비동기 호출에서 보안 설정을 참조하세요.

스크립트에서 objWbemAsyncContext 매개 변수를 사용하여 호출의 원본을 확인합니다.

요구 사항

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

추가 정보

SWbemServices
SWbemObject.Associators_
SWbemObject.AssociatorsAsync_
SWbemObject.References_
SWbemObject.ReferencesAsync_
SWbemServices.ReferencesTo
SWbemServices.ReferencesToAsync