IDirectXFileSaveObject::CreateDataObject-Methode

Erstellt ein Datenobjekt. Veraltet.

Syntax

HRESULT CreateDataObject(
  [in]                REFGUID           rguidTemplate,
  [in]                LPCSTR            szName,
  [in]          const GUID              *pguid,
  [in]                DWORD             cbSize,
  [in]                LPVOID            pvData,
  [out, retval]       LPDIRECTXFILEDATA *ppDataObj
);

Parameter

rguidTemplate [in]

Typ: REFGUID

GUID, die die Vorlage des Datenobjekts darstellt.

szName [in]

Typ: LPCSTR

Zeiger auf den Namen des Datenobjekts. Geben Sie NULL an, wenn das Objekt keinen Namen hat.

pguid [in]

Typ: const GUID*

Zeiger auf eine GUID, die das Datenobjekt darstellt. Geben Sie NULL an, wenn das Objekt keine GUID aufweist.

cbSize [in]

Typ: DWORD

Größe des Datenobjekts in Bytes.

pvData [in]

Typ: LPVOID

Zeiger auf einen Puffer, der alle erforderlichen Memberdaten enthält.

ppDataObj [out, retval]

Typ: LPDIRECTXFILEDATA*

Adresse eines Zeigers auf eine IDirectXFileData-Schnittstelle , die das erstellte Dateidatenobjekt darstellt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert DXFILE_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein. DXFILEERR_BADALLOC DXFILEERR_BADVALUE

Bemerkungen

Wenn ein Datenverweisobjekt auf das Datenobjekt verweist, muss entweder der szName- oder pguid-Parameter nicht NULL sein.

Speichern Sie alle Vorlagen mithilfe der IDirectXFileSaveObject::SaveTemplates-Methode , bevor Sie die mit dieser Methode erstellten Daten speichern. Speichern Sie die erstellten Daten mithilfe der IDirectXFileSaveObject::SaveData-Methode .

Wenn Sie optionale Daten speichern müssen, verwenden Sie die IDirectXFileData::AddDataObject-Methode nach der Verwendung dieser Methode und vor der Verwendung von IDirectXFileSaveObject::SaveData. Wenn das Objekt über untergeordnete Objekte verfügt, fügen Sie diese hinzu, bevor Sie IDirectXFileSaveObject::SaveData aufrufen.

Anforderungen

Siehe auch

IDirectXFileSaveObject

IDirectXFileData::AddDataObject

IDirectXFileSaveObject::SaveData

IDirectXFileSaveObject::SaveTemplates