Méthode ICallFrame ::ReleaseMarshalData (callobj.h)

Libère les ressources qui sont conservées par les pointeurs d’interface résidant dans un paquet de données marshalées. Cette méthode recherche tous les pointeurs d’interface dans le paquet et appelle la fonction CoReleaseMarshalData sur chacun d’eux.

Syntaxe

HRESULT ReleaseMarshalData(
  [in] PVOID                    pBuffer,
  [in] ULONG                    cbBuffer,
  [in] ULONG                    ibFirstRelease,
  [in] RPCOLEDATAREP            dataRep,
  [in] CALLFRAME_MARSHALCONTEXT *pcontext
);

Paramètres

[in] pBuffer

Pointeur vers la mémoire tampon contenant les valeurs [out] marshalées.

[in] cbBuffer

Taille de la mémoire tampon, en octets.

[in] ibFirstRelease

Premier octet de la mémoire tampon, qui doit être libéré. La valeur zéro implique que les pointeurs d’interface dans l’ensemble de la mémoire tampon doivent être libérés. Les pointeurs d’interface marshalés sont supposés avoir été libérés par un autre mécanisme.

[in] dataRep

Représentation de données avec laquelle les données ont été marshalées.

[in] pcontext

Pointeur vers la structure CALLFRAME_MARSHALCONTEXT contenant des informations de contexte sur la façon dont le marshaling est effectué.

Valeur retournée

Cette méthode peut retourner les valeurs suivantes.

Remarques

La méthode ReleaseMarshalData doit être appelée une seule fois pour propre les ressources contenues dans une mémoire tampon marshalée. Toutefois, lorsque l’énumération MSHLFLAGS est définie sur MSHLFLAGS_NORMAL, cette opération est effectuée automatiquement lors du marshaling et n’a donc pas besoin d’être effectuée explicitement.

Cette méthode peut fonctionner correctement sur les paramètres [in] et [out] marshalés.

Configuration requise

Voir aussi

ICallFrame