Метод IPortableDeviceResources::CreateResource (portabledeviceapi.h)
Метод CreateResource создает ресурс.
Синтаксис
HRESULT CreateResource(
[in] IPortableDeviceValues *pResourceAttributes,
[out] IStream **ppData,
[out] DWORD *pdwOptimalWriteBufferSize,
[out] LPWSTR *ppszCookie
);
Параметры
[in] pResourceAttributes
Указатель на следующие атрибуты параметров объекта.
| attribute | Описание |
|---|---|
| WPD_OBJECT_NAME | Имя объекта. |
| WPD_RESOURCE_ATTRIBUTE_TOTAL_SIZE | Общий размер потока данных ресурса. |
| WPD_RESOURCE_ATTRIBUTE_FORMAT | Формат потока данных ресурса. |
| WPD_RESOURCE_ATTRIBUTE_RESOURCE_KEY | Ключ ресурса. |
[out] ppData
Указатель на поток, в который вызывающий объект может записывать данные ресурсов.
[out] pdwOptimalWriteBufferSize
Указатель на значение, указывающее оптимальный размер буфера при записи в поток. Этот параметр является необязательным.
[out] ppszCookie
Указатель на файл cookie, который идентифицирует запрос на создание ресурса. Этот параметр является необязательным.
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
|
По крайней мере один из аргументов был указателем NULL . |
Комментарии
Когда приложение вызывает этот метод, оно должно указать атрибуты ресурса и записать необходимые данные в поток, возвращаемый этим методом.
Ресурс не создается при возврате метода; Он создается, когда приложение фиксирует данные путем вызова метода Commit в потоке, на который указывает ppData .
Чтобы отменить передачу данных в ресурс, приложение должно вызвать метод Revert в потоке, на который указывает ppData . После отмены передачи приложение должно вызвать IUnknown::Release , чтобы закрыть поток.
Требования
| Целевая платформа | Windows |
| Header | portabledeviceapi.h |
| Библиотека | PortableDeviceGUIDs.lib |