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 를 호출해야 합니다. 오류 코드가 반환되면 포인터는 수정되지 않은 상태로 남아 있습니다.

반환 값

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

설명

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

요구 사항

추가 정보

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::GetValue