IWbemContext::GetNames 메서드(wbemcli.h)

IWbemContext::GetNames 메서드는 명명된 컨텍스트 값의 모든 이름의 SAFEARRAY 구조를 반환합니다. 모든 이름이 알려지면 각 이름에 대해 GetValue 를 호출하여 값을 검색할 수 있습니다. 이 기술은 BeginEnumeration, Next 및 EndEnumeration 메서드를 호출하는 것과 다른 컨텍스트 값에 액세스하는 방법입니다.

구문

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

매개 변수

[in] lFlags

예약되어 있습니다. 이 매개 변수는 0이어야 합니다.

[out] pNames

이 매개 변수는 NULL일 수 없지만 항목에서 NULL을 가리킵니다. 오류가 반환되지 않으면 종료 시 pstrNames 는 모든 컨텍스트 값 이름을 포함하는 VT_BSTR 형식의 새 SAFEARRAY 구조체에 대한 포인터를 받습니다. 배열이 더 이상 필요하지 않은 경우 호출자는 반환된 포인터에서 SafeArrayDestroy 를 호출해야 합니다. 오류 코드가 반환되면 포인터는 수정되지 않은 상태로 남아 있습니다.

참고 개체에 명명된 값이 없으면 호출이 성공하고 길이가 0인 배열을 반환합니다.

 

반환 값

이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.

설명

BSTR 값의 SAFEARRAY 구조를 사용하는 방법에 대한 자세한 내용은 WMI 인스턴스의 일부 검색을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	wbemcli.h(Wbemidl.h 포함)
라이브러리	Wbemuuid.lib
DLL	Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

추가 정보

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::GetValue