IWbemServices::OpenNamespace 메서드(wbemcli.h)
IWbemServices::OpenNamespace 메서드는 지정된 자식 네임스페이스를 해당 운영 컨텍스트로 포함하는 새 IWbemServices 포인터를 호출자에게 제공합니다. 클래스 또는 instance 만들기와 같은 새 포인터를 통한 모든 작업은 해당 네임스페이스에만 영향을 줍니다. 네임스페이스는 이 메서드가 호출되는 현재 개체의 자식 네임스페이스여야 합니다.
구문
HRESULT OpenNamespace(
[in] const BSTR strNamespace,
[in] long lFlags,
[in] IWbemContext *pCtx,
[out] IWbemServices **ppWorkingNamespace,
[out] IWbemCallResult **ppResult
);
매개 변수
[in] strNamespace
대상 네임스페이스의 경로입니다. 자세한 내용은 WMI 내에서 계층 구조 만들기를 참조하세요. 이 네임스페이스는 IWbemServices 인터페이스 포인터와 연결된 현재 네임스페이스를 기준으로 할 수 있습니다. 이 매개 변수는 절대 경로 또는 NULL일 수 없습니다.
[in] lFlags
이 매개 변수를 0으로 설정하여 동기 호출로 만들 수 있습니다. 이 호출을 반동기 호출로 만들려면 lFlags 를 WBEM_FLAG_RETURN_IMMEDIATELY 설정하고 ppResult 매개 변수에 대한 유효한 포인터를 제공하면 이 호출이 즉시 반환됩니다. 자세한 내용은 메서드 호출을 참조하세요.
[in] pCtx
예약되어 있습니다. 이 매개 변수는 NULL이어야 합니다.
[out] ppWorkingNamespace
새 네임스페이스 컨텍스트를 나타내는 개체를 받습니다. 반환된 포인터에는 양의 참조 수가 있습니다. 호출자는 더 이상 필요하지 않은 경우 이 포인터에서 Release 를 호출해야 합니다. 오류가 있는 경우 이 포인터는 NULL 로 설정됩니다. 이 매개 변수를 지정한 경우 ppResult 는 NULL이어야 합니다.
[out] ppResult
일반적으로 NULL입니다. NULL이 아닌 경우 ppWorkingNamespace는 NULL이어야 합니다. 이 경우 매개 변수는 새 IWbemCallResult 개체에 대한 포인터를 받습니다. lFlags 매개 변수가 WBEM_FLAG_RETURN_IMMEDIATELY 로 설정된 경우 이 호출은 즉시 반환됩니다. 그런 다음 호출자는 요청된 네임스페이스에 대한 포인터를 사용할 수 있게 될 때까지 IWbemCallResult::GetResultServices 메서드를 주기적으로 폴링할 수 있습니다. 이 매개 변수는 오류가 있고 새 개체가 반환되지 않을 때 NULL 을 가리키도록 설정됩니다.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT에 포함된 값이 나열되어 있습니다.
실패 시 COM 함수 GetErrorInfo에서 사용 가능한 정보를 가져올 수 있습니다.
네트워크 문제로 인해 Windows Management에 대한 원격 연결이 끊어지는 경우에도 COM 관련 오류 코드가 반환될 수 있습니다.
설명
IWbemLocator::ConnectServer 메서드를 사용하여 동일한 네임스페이스를 열 수도 있습니다. 유일한 차이점은 OpenNamespace 메서드를 사용하면 네임스페이스 매개 변수에 상대 개체 경로를 배치하여 자식 네임스페이스를 재귀적으로 열 수 있다는 것입니다. IWbemLocator::ConnectServer 에는 전체 개체 경로가 필요합니다. 자세한 내용은 WMI 네임스페이스 개체 경로 설명을 참조하세요.
예를 들어 IWbemServices 인터페이스 포인터와 연결된 현재 네임스페이스가 루트인 경우 네임스페이스 매개 변수에서 Default를 사용하면 root\default 네임스페이스에 바인딩된 새 포인터가 생성됩니다.
릴리스가 호출되고 참조 수가 0에 도달하면 네임스페이스가 닫힙니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | wbemcli.h(Wbemidl.h 포함) |
| 라이브러리 | Wbemuuid.lib |
| DLL | Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll |