XFileSaveObject.AddDataObject Method

 Language:

Adds a data object as a child of the XFileSaveData object.

Definition

Visual Basic Public Function AddDataObject( _
    ByVal guidTemplate As Guid, _
    ByVal name As String, _
    ByVal guidData As Guid, _
    ByVal data() As Byte _
) As XFileSaveData
C# public XFileSaveData AddDataObject(
    Guid guidTemplate,
    string name,
    Guid guidData,
    byte[] data
);
C++ public:
XFileSaveData^ AddDataObject(
    Guid guidTemplate,
    String^ name,
    Guid guidData,
    array<unsigned char>^ data
);
JScript public function AddDataObject(
    guidTemplate : Guid,
    name : String,
    guidData : Guid,
    data : byte[]
) : XFileSaveData;

Parameters

guidTemplate System.Guid
The globally unique identifier (GUID) representing the data object's template.
name System.String
The name of the data object. Specify null if the data object does not have a name.
guidData System.Guid
A GUID representing the data object. Specify null if the object does not have a GUID.
data System.Byte[]
A Byte Leave Site array as a buffer containing all required data in the data object.

Return Value

Microsoft.DirectX.Direct3D.XFileSaveData
An XFileSaveData object representing the file data node to which the data object will be added.

Remarks

If a data reference object will reference the data object, either the name or guidData parameter must be non-null.

Save the created data to disk by using the XFileSaveObject.Save method.

Exception GraphicsException.ErrorCode Cause
GraphicsException XFileErrorCodes.BadObject Data could not be read from or written to an object.
XFileErrorCodes.BadValue A variable is outside its expected range; typically returned when an object is invalid.
OutOfMemoryException Leave Site N/A Microsoft Direct3D could not allocate sufficient memory to complete the call.

Send comments about this topic to Microsoft. © Microsoft Corporation. All rights reserved.

Feedback? Please provide us with your comments on this topic.