fonction MI_Serializer_SerializeInstance (mi.h)

Sérialise un MI_Instance dans une mémoire tampon au format spécifié lors de la création du sérialiseur. Les options peuvent être passées dans les indicateurs pour contrôler si la classe est également sérialisée dans la mémoire tampon ainsi que dans le instance.

Syntaxe

MI_INLINE MI_Result MI_Serializer_SerializeInstance(
  [in, out] MI_Serializer     *serializer,
            MI_Uint32         flags,
  [in]      const MI_Instance *instanceObject,
            MI_Uint8          *clientBuffer,
            MI_Uint32         clientBufferLength,
  [in, out] MI_Uint32         *clientBufferNeeded
);

Paramètres

[in, out] serializer

Sérialiseur retourné par MI_Application_NewSerializer.

flags

Doit être 0 ou MI_SERIALIZER_FLAGS_INSTANCE_WITH_CLASS. 0 signifie sérialiser le instance uniquement. MI_SERIALIZER_FLAGS_INSTANCE_WITH_CLASS signifie sérialiser le instance et toutes les parties de classe dans la mémoire tampon afin qu’il soit autonome.

[in] instanceObject

Objet instance à sérialiser.

clientBuffer

Mémoire tampon de sortie pour recevoir les données de classe sérialisées. Si ce paramètre a la valeur Null, la longueur requise de la mémoire tampon est renvoyée dans clientBufferNeededed.

clientBufferLength

Longueur du clientBuffer passé. Si clientBuffer a la valeur Null, ce paramètre doit être 0.

[in, out] clientBufferNeeded

Longueur totale retournée de la mémoire tampon. Si une mémoire tampon est transmise (via le paramètre clientBuffer ) de la taille requise ou plus, cette valeur indique la quantité de mémoire tampon utilisée. Si une mémoire tampon n’a pas été transmise (où la valeur clientBuffer est Null) ou si la mémoire tampon est trop petite pour contenir la classe sérialisée, cette valeur indique l’espace nécessaire pour contenir la classe sérialisée.

Valeur retournée

Valeur de l’énumération MI_Result qui spécifie le code de retour de fonction. Il peut s’agir de l’un des codes suivants.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	mi.h
Composant redistribuable	Windows Management Framework 3.0 sur Windows Server 2008 R2 avec SP1, Windows 7 avec SP1 et Windows Server 2008 avec SP2

Voir aussi

MI_Application_NewSerializer