IWSDDeviceProxy::GetThisDeviceMetadata (Compact 2013)
3/26/2014
This method retrieves device-specific metadata for this device.
Syntax
HRESULT GetThisDeviceMetadata(
WSD_THIS_DEVICE_METADATA** ppThisDeviceMetadata
);
Parameters
- ppThisDeviceMetadata
[out] Reference to a WSD_THIS_DEVICE_METADATA structure that specifies the device-specific metadata of this device. Do not release this object.
Return Value
The following table shows the possible error code return values.
Error code |
Description |
---|---|
S_OK |
This method completed successfully. |
E_POINTER |
ppThisDeviceMetadata is NULL. |
Remarks
GetThisDeviceMetadata will not cause the device proxy to retrieve metadata from the device. Instead, GetThisDeviceMetadata will return the metadata retrieved with the last call to IWSDDeviceProxy::BeginGetMetadata and IWSDDeviceProxy::EndGetMetadata. If neither of these methods has been called, GetThisDeviceMetadata will return the metadata retrieved when the IWSDDeviceProxy object was initialized.
Upon success, the memory at ppMetadata will be valid until BeginGetMetadata or EndGetMetadata is called or until the IWSDDeviceProxy object is released.
Requirements
Header |
wsdapi.h |
Library |
wsdapi.lib |