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 的指针。 如果对象没有 GUID,则指定 NULL 。
-
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 方法保存创建的数据。
如果需要保存可选数据,请在使用此方法后和使用 IDirectXFileSaveObject::SaveData 之前使用 IDirectXFileData::AddDataObject 方法。 如果对象具有子对象,请在调用 IDirectXFileSaveObject::SaveData 之前添加它们。
要求
要求 | 值 |
---|---|
标头 |
|
库 |
|
另请参阅