Sdílet prostřednictvím

Pravidla správy paměti

  • Článek

Životnost ukazatelů na rozhraní je vždy spravována prostřednictvím metody AddRef a Release na každém rozhraní COM. Další informace naleznete v tématu Pravidla pro správu počtu odkazů.

Pro všechny ostatní parametry je důležité dodržovat určitá pravidla pro správu paměti. Následující pravidla platí pro všechny parametry metod rozhraní včetně návratové hodnoty, které nejsou předány hodnotou:

  • Volající musí přidělit a uvolnit parametry v parametrech.
  • Parametry out-musí být přiděleny volanou; Uvolní je volající pomocí standardního alokátoru paměti úlohy MODELU COM. Další informace najdete v tématu Alokátor paměti OLE.
  • Parametry in/out-parameters jsou původně přiděleny volajícím a v případě potřeby uvolněny a relokovány volaným. Stejně jako u parametrů out je volající zodpovědný za uvolnění konečné vrácené hodnoty. Je nutné použít standardní alokátor paměti modelu COM.

V posledních dvou případech, kdy jeden kus kódu přidělí paměť a jinou část kódu uvolní, pomocí alokátoru COM zajistí, že dva části kódu používají stejné metody přidělování.

Další oblastí, která vyžaduje zvláštní pozornost, je ošetření out a in-out parametrů v podmínkách selhání. Pokud funkce vrátí kód selhání, volající obvykle nemá žádný způsob, jak vyčistit nebo vymazal parametry. To vede k následujícím dalším pravidlům:

  • V případě chybového stavu musí být parametry vždy spolehlivě nastaveny na hodnotu, která se vyčistí bez jakékoli akce volajícího.
  • Všechny parametry ukazatele musí být explicitně nastaveny na NULL. Obvykle se předávají v parametru ukazatele na ukazatel, ale mohou být předány také jako členy struktury, kterou volající přiděluje, a volané výplně kódu. Nejjednodušší způsob, jak zajistit, aby se tyto hodnoty (částečně) nastavily na null při zadávání funkce. Toto pravidlo je důležité, protože podporuje robustnější interoperabilitu aplikací.
  • Za chybových podmínek musí být všechny parametry in-out buď ponechány samostatně volaný kódem (tedy zůstávají na hodnotě, do které byly inicializovány volajícím) nebo musí být explicitně nastaveny, jako v případě vrácení chyby výstupního parametru.

Mějte na paměti, že tyto konvence správy paměti pro aplikace MODELU COM platí pouze pro veřejná rozhraní a rozhraní API; není nutné, aby přidělení paměti výhradně interní pro aplikaci MODELU COM bylo nutné provádět pomocí těchto mechanismů.

Com interně používá ke komunikaci mezi klienty a servery vzdálená volání procedur (RPC). Další informace o správě paměti v procedurách serveru RPC naleznete v tématu Správa paměti zástupné procedury serveru.