IActiveScriptProfilerControl5::EnumHeap2, méthodeIActiveScriptProfilerControl5::EnumHeap2 Method

Retourne une interface (iactivescriptprofilerheapenum, Interface) qui peut être utilisé pour itérer sur les objets du tas GC dans le contexte du moteur de script associé.Returns an interface (IActiveScriptProfilerHeapEnum Interface) that can be used to iterate over the GC heap objects in the context of the associated script engine.

Vous pouvez appeler cette méthode dans un débogage ou en mode version finale.You can call this method in either debug or release mode. Cette méthode doit être appelée lorsque le thread d’interface utilisateur est inactif.This method should be called when UI thread is idle. Une fois que la méthode a été appelée, aucune opération ne doit être effectuée dans le moteur de script à l’exception de iactivescriptprofilerheapenum::Next, méthode jusqu'à ce que iactivescriptprofilerheapenum::Next, méthoderetourne S_FALSE ou iactivescriptprofilerheapenum, Interface pointeur d’interface est libéré.After the method has been called, no operations should be performed against the script engine except IActiveScriptProfilerHeapEnum::Next Method until IActiveScriptProfilerHeapEnum::Next Method returns S_FALSE or the IActiveScriptProfilerHeapEnum Interface interface pointer is released.

SyntaxeSyntax

HRESULT EnumHeap2(    [in] PROFILER_HEAP_ENUM_FLAGS enumFlags,    [out] IActiveScriptProfilerHeapEnum** ppEnum);  

ParamètresParameters

enumFlagsenumFlags
Valeur qui spécifie si des informations supplémentaires sur un objet vers lequel pointé dans une relation d’objet sont exposées.Value that specifies whether extra information about an object pointed to in an object relationship is exposed. Informations supplémentaires peuvent indiquer si l’objet désigné est une méthode d’accesseur Get ou Set.Extra information may indicate whether the object pointed to is a getter or setter method. Pour plus d’informations, consultez profiler_heap_object_flags, énumération.For more info, see PROFILER_HEAP_ENUM_FLAGS Enumeration.

ppEnumppEnum
[out] Retourne le iactivescriptprofilerheapenum, Interface.[out] Returns the IActiveScriptProfilerHeapEnum Interface.

Valeur de retourReturn Value

Retourne une valeur HRESULT.Returns an HRESULT. Les valeurs possibles sont les suivantes :Possible values are as follows:

Valeur de retourReturn Value SignificationMeaning
S_OK L’énumération de segment de mémoire s’est terminée correctement.The heap enumeration completed successfully.
E_OUTOFMEMORY Il n’a pas assez de mémoire disponible pour effectuer l’énumération de tas.There was not enough memory available to perform heap enumeration.
E_FAIL Une erreur interne s’est produite.An internal error occurred.