Метод IDirectXFileSaveObject::CreateDataObject
Создает объект данных. Не рекомендуется.
Синтаксис
HRESULT CreateDataObject(
[in] REFGUID rguidTemplate,
[in] LPCSTR szName,
[in] const GUID *pguid,
[in] DWORD cbSize,
[in] LPVOID pvData,
[out, retval] LPDIRECTXFILEDATA *ppDataObj
);
Параметры
-
rguidTemplate [in]
-
Тип: REFGUID
GUID, представляющий шаблон объекта данных.
-
szName [in]
-
Тип: LPCSTR
Указатель на имя объекта данных. Укажите ЗНАЧЕНИЕ NULL , если у объекта нет имени.
-
pguid [in]
-
Тип: const GUID*
Указатель на GUID, представляющий объект данных. Укажите ЗНАЧЕНИЕ NULL , если у объекта нет GUID.
-
cbSize [in]
-
Тип: DWORD
Размер объекта данных в байтах.
-
pvData [in]
-
Тип: LPVOID
Указатель на буфер, содержащий все необходимые данные элемента.
-
ppDataObj [out, retval]
-
Тип: LPDIRECTXFILEDATA*
Адрес указателя на интерфейс IDirectXFileData , представляющий созданный объект данных файла.
Возвращаемое значение
Тип: HRESULT
Если метод выполнен успешно, возвращаемое значение будет DXFILE_OK. Если метод завершается ошибкой, возвращаемое значение может быть одним из следующих значений. DXFILEERR_BADALLOC DXFILEERR_BADVALUE
Комментарии
Если объект ссылки на данные ссылается на объект данных, параметр szName или pguid должен иметь значение, отличное от NULL.
Сохраните все шаблоны с помощью метода IDirectXFileSaveObject::SaveTemplates перед сохранением данных, созданных этим методом. Сохраните созданные данные с помощью метода IDirectXFileSaveObject::SaveData .
Если необходимо сохранить необязательные данные, используйте метод IDirectXFileData::AddDataObject после использования этого метода и перед использованием IDirectXFileSaveObject::SaveData. Если у объекта есть дочерние объекты, добавьте их перед вызовом IDirectXFileSaveObject::SaveData.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел