IDirectXFileSaveObject :: CreateDataObject, méthode
Crée un objet de données. Action déconseillée.
Syntaxe
HRESULT CreateDataObject(
[in] REFGUID rguidTemplate,
[in] LPCSTR szName,
[in] const GUID *pguid,
[in] DWORD cbSize,
[in] LPVOID pvData,
[out, retval] LPDIRECTXFILEDATA *ppDataObj
);
Paramètres
-
rguidTemplate [ dans]
-
Type : REFGUID
GUID représentant le modèle de l’objet de données.
-
szName [ dans]
-
Type : LPCSTR
Pointeur vers le nom de l’objet de données. Spécifiez null si l’objet n’a pas de nom.
-
pguid [ dans]
-
Type : const GUID *
Pointeur vers un GUID représentant l’objet de données. Spécifiez null si l’objet n’a pas de GUID.
-
cbSize [ dans]
-
Type : DWORD
Taille de l’objet de données, en octets.
-
pvData [ dans]
-
Type : LPVOID
Pointeur vers une mémoire tampon contenant toutes les données du membre requis.
-
ppDataObj [ out, retval]
-
Type : LPDIRECTXFILEDATA*
Adresse d’un pointeur vers une interface IDirectXFileData , représentant l’objet de données de fichier créé.
Valeur retournée
Type : HRESULT
Si la méthode est réussie, la valeur de retour est DXFILE _ OK. Si la méthode échoue, la valeur de retour peut être l’une des valeurs suivantes. DXFILEERR _ BADALLOC DXFILEERR _ BADVALUE
Remarques
Si un objet de référence de données fait référence à l’objet de données, le paramètre szName ou pguid doit avoir une valeur non null.
Enregistrez les modèles à l’aide de la méthode IDirectXFileSaveObject :: SaveTemplates avant d’enregistrer les données créées par cette méthode. Enregistrez les données créées à l’aide de la méthode IDirectXFileSaveObject :: SaveData .
Si vous devez enregistrer des données facultatives, utilisez la méthode IDirectXFileData :: AddDataObject après avoir utilisé cette méthode et avant d’utiliser IDirectXFileSaveObject :: SaveData. Si l’objet a des objets enfants, ajoutez-les avant d’appeler IDirectXFileSaveObject :: SaveData.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|