Skip to content

Latest commit

 

History

History
154 lines (102 loc) · 6.24 KB

nf-wbemcli-iwbemservices-getobject.md

File metadata and controls

154 lines (102 loc) · 6.24 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:wbemcli.IWbemServices.GetObject
IWbemServices::GetObject (wbemcli.h)
The IWbemServices::GetObject method retrieves a class or instance. This method only retrieves objects from the namespace associated with the current IWbemServices object.
GetObject
GetObject method [Windows Management Instrumentation]
GetObject method [Windows Management Instrumentation]
IWbemServices interface
IWbemServices interface [Windows Management Instrumentation]
GetObject method
IWbemServices.GetObject
IWbemServices::GetObject
WBEM_FLAG_DIRECT_READ
WBEM_FLAG_RETURN_IMMEDIATELY
WBEM_FLAG_RETURN_WBEM_COMPLETE
WBEM_FLAG_USE_AMENDED_QUALIFIERS
_hmm_iwbemservices_getobject
wbemcli/IWbemServices::GetObject
wmi.iwbemservices_getobject
wmi\iwbemservices_getobject.htm
wmi
68150273-c4ec-46f1-a3e6-d7169824b69d
12/05/2018
GetObject, GetObject method [Windows Management Instrumentation], GetObject method [Windows Management Instrumentation],IWbemServices interface, IWbemServices interface [Windows Management Instrumentation],GetObject method, IWbemServices.GetObject, IWbemServices::GetObject, WBEM_FLAG_DIRECT_READ, WBEM_FLAG_RETURN_IMMEDIATELY, WBEM_FLAG_RETURN_WBEM_COMPLETE, WBEM_FLAG_USE_AMENDED_QUALIFIERS, _hmm_iwbemservices_getobject, wbemcli/IWbemServices::GetObject, wmi.iwbemservices_getobject
wbemcli.h
Wbemidl.h
Windows
Windows Vista
Windows Server 2008
Wbemuuid.lib
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
Windows
19H1
IWbemServices::GetObject
wbemcli/IWbemServices::GetObject
c++
APIRef
kbSyntax
COM
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
IWbemServices.GetObject

IWbemServices::GetObject

-description

The IWbemServices::GetObject method retrieves a class or instance. This method only retrieves objects from the namespace associated with the current IWbemServices object.

-parameters

-param strObjectPath [in]

Path of the object to retrieve. If this is NULL, an empty object is returned that can become a new class. For more information, see Creating a Class.

-param lFlags [in]

The following flags affect the behavior of this method.

WBEM_FLAG_USE_AMENDED_QUALIFIERS

If this flag is set, WMI retrieves the amended qualifiers stored in the localized namespace of the current connection's locale. If not set, only the qualifiers stored in the immediate namespace are retrieved.

WBEM_FLAG_RETURN_WBEM_COMPLETE

This flag makes this a synchronous call.

WBEM_FLAG_RETURN_IMMEDIATELY

This flag makes this a semisynchronous call. You must provide a valid pointer for the ppCallResult parameter. For more information, see Calling a Method.

WBEM_FLAG_DIRECT_READ

This flag causes direct access to the provider for the class specified without any regard to its parent class or subclasses.

-param pCtx [in]

Typically NULL. Otherwise, this is a pointer to an IWbemContext object that may be used by the provider that is producing the requested class or instance. The values in the context object must be specified in the documentation for the provider in question. For more information about this parameter, see Making Calls to WMI.

-param ppObject [out]

If not NULL, this receives the object, if it is found. The returned object has a positive reference count. The caller must use Release when the object is no longer needed. In all cases of error, this parameter is set to point to NULL.

-param ppCallResult [out]

If NULL, this parameter is not used. If the lFlags parameter contains WBEM_FLAG_RETURN_IMMEDIATELY, this call returns immediately with WBEM_S_NO_ERROR. The ppCallResult parameter receives a pointer to a new IWbemCallResult object, which can then be polled to obtain the result using the GetCallStatus method. The caller can call IWbemCallResult::GetResultObject to retrieve the object when it becomes available.

-returns

This method returns an HRESULT indicating the status of the method call. The following list lists the value contained within an HRESULT.

On failure, you can obtain any available information from the COM function GetErrorInfo.

COM-specific error codes also may be returned if network problems cause you to lose the remote connection to Windows Management.

-see-also

Creating a Class

Describing the Location of a WMI Object

IWbemCallResult

IWbemServices

IWbemServices::GetObjectAsync

Retrieving an Error Code