Задание свойств для одного объекта
Когда приложение получает идентификатор объекта (см. раздел "Перечисление содержимого ") для данного объекта, он может задать свойства этого объекта, вызвав методы в интерфейсах, описанных в следующей таблице.
| Интерфейс | Описание |
|---|---|
| Интерфейс IPortableDeviceProperties | Используется для определения возможности записи заданного свойства и отправки операции записи. |
| Интерфейс IPortableDeviceContent | Предоставляет доступ к методам, зависящим от содержимого. |
| Интерфейс IPortableDeviceValues | Используется для хранения записываемых значений, определения результатов операции записи и получения атрибутов свойств (при определении возможности записи). |
Приложения задают свойства объекта путем создания контейнера свойств, который задает новые значения с помощью интерфейса IPortableDeviceValues. После создания контейнера свойств приложение задает эти свойства путем вызова метода IPortableDeviceProperties::SetValues .
Функция WriteContentProperties в модуле ContentProperties.cpp примера приложения демонстрирует, как приложение может задать новое свойство имени объекта для выбранного объекта.
Первая задача, выполняемая WriteContentProperties функцией, — предложить пользователю ввести идентификатор объекта для объекта, для который приложение будет записывать новое имя.
HRESULT hr = S_OK;
WCHAR szSelection[81] = {0};
WCHAR szNewObjectName[81] = {0};
CComPtr<IPortableDeviceProperties> pProperties;
CComPtr<IPortableDeviceContent> pContent;
CComPtr<IPortableDeviceValues> pObjectPropertiesToWrite;
CComPtr<IPortableDeviceValues> pPropertyWriteResults;
CComPtr<IPortableDeviceValues> pAttributes;
BOOL bCanWrite = FALSE;
// Prompt user to enter an object identifier on the device to write properties on.
printf("Enter the identifer of the object you wish to write properties on.\n>");
hr = StringCbGetsW(szSelection,sizeof(szSelection));
if (FAILED(hr))
{
printf("An invalid object identifier was specified, aborting property reading\n");
}
После этого приложение получает значение WPD_PROPERTY_ATTRIBUTE_CAN_WRITE для свойства WPD_OBJECT_NAME, чтобы определить, можно ли записать это свойство. (Обратите внимание, что приложение может задать любое свойство, для которого значение WPD_PROPERTY_ATTRIBUTE_CAN_WRITE имеет значение true.)
if (SUCCEEDED(hr))
{
hr = pDevice->Content(&pContent);
if (FAILED(hr))
{
printf("! Failed to get IPortableDeviceContent from IPortableDevice, hr = 0x%lx\n",hr);
}
}
// 2) Get an IPortableDeviceProperties interface from the IPortableDeviceContent interface
// to access the property-specific methods.
if (SUCCEEDED(hr))
{
hr = pContent->Properties(&pProperties);
if (FAILED(hr))
{
printf("! Failed to get IPortableDeviceProperties from IPortableDevice, hr = 0x%lx\n",hr);
}
}
// 3) Check the property attributes to see if we can write/change the WPD_OBJECT_NAME property.
if (SUCCEEDED(hr))
{
hr = pProperties->GetPropertyAttributes(szSelection,
WPD_OBJECT_NAME,
&pAttributes);
if (SUCCEEDED(hr))
{
hr = pAttributes->GetBoolValue(WPD_PROPERTY_ATTRIBUTE_CAN_WRITE, &bCanWrite);
if (SUCCEEDED(hr))
{
if (bCanWrite)
{
printf("The attribute WPD_PROPERTY_ATTRIBUTE_CAN_WRITE for the WPD_OBJECT_NAME reports TRUE\nThis means that the property can be changed/updated\n\n");
}
else
{
printf("The attribute WPD_PROPERTY_ATTRIBUTE_CAN_WRITE for the WPD_OBJECT_NAME reports FALSE\nThis means that the property cannot be changed/updated\n\n");
}
}
else
{
printf("! Failed to get the WPD_PROPERTY_ATTRIBUTE_CAN_WRITE value from WPD_OBJECT_NAME on object '%ws', hr = 0x%lx\n",szSelection, hr);
}
}
}
Следующим шагом является запрос пользователя на ввод новой строки имени. (Обратите внимание, что вызов метода IPortableDeviceValues::SetStringValue просто создает контейнер свойств; фактическое свойство еще не записано.)
if (bCanWrite)
{
printf("Enter the new WPD_OBJECT_NAME for the object '%ws'.\n>",szSelection);
hr = StringCbGetsW(szNewObjectName,sizeof(szNewObjectName));
if (FAILED(hr))
{
printf("An invalid object name was specified, aborting property writing\n");
}
// 5) CoCreate an IPortableDeviceValues interface to hold the property values
// we wish to write.
if (SUCCEEDED(hr))
{
hr = CoCreateInstance(CLSID_PortableDeviceValues,
NULL,
CLSCTX_INPROC_SERVER,
IID_PPV_ARGS(&pObjectPropertiesToWrite));
if (SUCCEEDED(hr))
{
if (pObjectPropertiesToWrite != NULL)
{
hr = pObjectPropertiesToWrite->SetStringValue(WPD_OBJECT_NAME, szNewObjectName);
if (FAILED(hr))
{
printf("! Failed to add WPD_OBJECT_NAME to IPortableDeviceValues, hr= 0x%lx\n", hr);
}
}
}
}
Наконец, новое значение, указанное пользователем, применяется к объекту.
if (SUCCEEDED(hr))
{
hr = pProperties->SetValues(szSelection, // The object whose properties we are reading
pObjectPropertiesToWrite, // The properties we want to read
&pPropertyWriteResults); // Driver supplied property result values for the property read operation
if (FAILED(hr))
{
printf("! Failed to set properties for object '%ws', hr= 0x%lx\n", szSelection, hr);
}
else
{
printf("The WPD_OBJECT_NAME property on object '%ws' was written successfully (Read the properties again to see the updated value)\n", szSelection);
}
}
Связанные темы