다음을 통해 공유

GetNames 함수

개체 속성의 하위 집합 또는 모든 이름을 검색합니다.

참고

이 API는 내부 전용입니다. 개발자 코드에서 사용할 수 없습니다.

구문

HRESULT GetNames (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszQualifierName,
   [in] LONG                lFlags,
   [in] VARIANT*            pQualifierValue,
   [out] SAFEARRAY (BSTR)** pstrNames
);

매개 변수

vFunc
[in] 이 매개 변수는 사용되지 않습니다.

ptr
[in] IWbemClassObject 인스턴스에 대한 포인터입니다.

wszQualifierName
[in] 필터의 일부로 작동하는 한정자 이름을 지정하는 유효한 LPCWSTR에 대한 포인터입니다. 자세한 내용은 설명 섹션을 참조하세요. 이 매개 변수는 null일 수 있습니다.

lFlags
[in] 비트 필드의 조합입니다. 자세한 내용은 설명 섹션을 참조하세요.

pQualifierValue [in] 필터 값으로 초기화된 유효한 VARIANT 구조체에 대한 포인터입니다. 이 매개 변수는 null일 수 있습니다.

pstrNames
[out] 속성 이름을 포함하는 SAFEARRAY 구조체입니다. 항목에서 이 매개 변수는 항상 null에 대한 포인터여야 합니다. 자세한 내용은 설명 섹션을 참조하세요.

반환 값

이 함수가 반환하는 다음 값은 WbemCli.h 헤더 파일에 정의되어 있거나 코드에서 상수로 정의할 수 있습니다.

상수 값 Description
WBEM_E_FAILED 0x80041001 일반적인 오류가 발생했습니다.
WBEM_E_INVALID_PARAMETER 0x80041008 하나 이상의 매개 변수가 잘못되었거나 플래그와 매개 변수의 잘못된 조합이 지정되었습니다.
WBEM_E_OUT_OF_MEMORY 0x80041006 메모리가 부족 하 여 작업을 완료할 수 없습니다.
WBEM_S_NO_ERROR 0 함수 호출에 성공했습니다.

설명

이 함수는 IWbemClassObject::GetNames 메서드에 대한 호출을 래핑합니다.

반환된 이름은 플래그와 매개 변수의 조합으로 제어됩니다. 예를 들어 함수는 모든 속성의 이름 또는 키 속성의 이름만 반환할 수 있습니다. 기본 필터는 lFlags 매개 변수에 지정되며 다른 매개 변수는 매개 변수에 따라 다릅니다.

lFlags의 플래그 값은 비트 필드입니다.

lEnumFlags 인수로 전달할 수 있는 플래그는 WbemCli.h 헤더 파일에 비트 필드로 정의되거나 코드에서 상수로 정의할 수 있습니다. 각 그룹의 플래그를 다른 그룹의 모든 플래그와 결합할 수 있습니다. 그러나 동일한 그룹의 플래그는 상호 배타적입니다.

그룹 1 플래그 값 설명
WBEM_FLAG_ALWAYS 0 모든 속성 이름을 반환합니다. strQualifierName 및 pQualifierVal은 사용되지 않습니다.
WBEM_FLAG_ONLY_IF_TRUE 1 strQualifierName 매개 변수에서 지정한 이름의 한정자가 있는 속성만 반환합니다. 이 플래그를 사용하는 경우 strQualifierName을 지정해야 합니다.
WBEM_FLAG_ONLY_IF_FALSE 2 strQualifierName 매개 변수에서 지정된 이름의 한정자가 없는 속성만 반환합니다. 이 플래그를 사용하는 경우 strQualifierName을 지정해야 합니다.
WBEM_FLAG_ONLY_IF_IDENTICAL 3 wszQualifierName 매개 변수에서 지정한 이름의 한정자가 있고 pQualifierVal 구조체에서 지정한 값과 동일한 값이 있는 속성만 반환합니다. 이 플래그를 사용하는 경우 wszQualifierName 및 pQualifierValue를 모두 지정해야 합니다.
그룹 2 플래그 값 Description
WBEM_FLAG_KEYS_ONLY 0x4 키를 정의하는 속성의 이름만 반환합니다.
WBEM_FLAG_REFS_ONLY 0x8 개체 참조인 속성 이름만 반환합니다.
그룹 3 플래그 값 Description
WBEM_FLAG_LOCAL_ONLY 0x10 가장 많이 파생된 클래스에 속하는 속성 이름만 반환합니다. 부모 클래스에서 속성을 제외합니다.
WBEM_FLAG_PROPAGATED_ONLY 0x20 부모 클래스에 속하는 속성 이름만 반환합니다.
WBEM_FLAG_SYSTEM_ONLY 0x30 시스템 속성의 이름만 반환합니다.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 비시스템 속성의 이름만 반환합니다.

WBEM_S_NO_ERROR를 반환하는 경우 함수는 항상 새 SAFEARRAY를 할당하며, pstrNames는 항상 함수를 가리키도록 설정됩니다. 반환된 배열에는 지정된 필터와 일치하는 속성이 없는 경우 0개의 요소가 있을 수 있습니다. 함수가 WBM_S_NO_ERROR 이외의 값을 반환하는 경우 새 SAFEARRAY 구조체가 반환되지 않습니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: WMINet_Utils.idl

.NET Framework 버전: 4.7.2부터 사용 가능

참고 항목

  • Last updated on