5/13/2011

This method is used by the device imaging component to query for additional information about a target device identified by the DeploymentJobIDand DeviceIDparameters.

Syntax 

HRESULT GetDeviceProperty(
  const BSTR 
DeploymentJobID,
  const BSTR 
DeviceID,
  const BSTR 
PropertyName,
  VARIANT* 
pPropertyValue
);

Parameters

DeploymentJobID

[in] ID of the device imaging deployment.

DeviceID

[in] ID of the device.

PropertyName

[in] Name of the device property.

pPropertyValue

[out] Pointer to the value of the specified device property.

Return Value

The following table shows the possible return values.

Value

Description

S_OK

Success.

E_INVALIDARG

Invalid parameter passed to the method.

E_OUTOFMEMORY

OUT parameter contains insufficient buffer.

E_FAIL

OUT parameter is invalid (access violation).

Remarks

The values for the PropertyNamestring include the following:

  • DeviceName

  • DeviceIPs

  • DeviceMACs

  • WriteFilterStatus

You can add new values by using extensible device properties. For more information, see Adding Device Properties.

See Also