IWSDDeviceProxy::GetAllMetadata (Compact 2013)
3/26/2014
This method retrieves all metadata for this device.
Syntax
HRESULT GetAllMetadata(
WSD_METADATA_SECTION_LIST** ppMetadata
);
Parameters
- ppMetadata
[out] Reference to a WSD_METADATA_SECTION_LIST structure that specifies all metadata related to a 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 |
ppMetadata is NULL. |
Remarks
This method is supplied so that extended metadata may be accessed. Manufacturer, service host and device-specific metadata are best obtained using methods provided specifically for those purposes.
GetAllMetadata will not cause the device proxy to retrieve metadata from the device. Instead, GetAllMetadata will return the metadata retrieved with the last call to IWSDDeviceProxy::BeginGetMetadata and IWSDDeviceProxy::EndGetMetadata. If neither of these methods has been called, GetAllMetadata 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 |