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
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch