IVsCoTaskMemFreeMyStrings – rozhraní

Článek
08/05/2016

Použito ve spojení s některých jiných rozhraní označíte, že volající by uvolnění řetězců vrátil z těchto rozhraních.

Obor názvů: Microsoft.VisualStudio.Shell.Interop
Sestavení: Microsoft.VisualStudio.Shell.Interop.8.0 (v Microsoft.VisualStudio.Shell.Interop.8.0.dll)

Syntaxe

[InterfaceTypeAttribute(1)]
[GuidAttribute("47811DA4-330F-4EB5-9D14-BBC82773DA66")]
public interface IVsCoTaskMemFreeMyStrings

[InterfaceTypeAttribute(1)]
[GuidAttribute("47811DA4-330F-4EB5-9D14-BBC82773DA66")]
public interface class IVsCoTaskMemFreeMyStrings

[<InterfaceTypeAttribute(1)>]
[<GuidAttribute("47811DA4-330F-4EB5-9D14-BBC82773DA66")>]
type IVsCoTaskMemFreeMyStrings = interface end

<InterfaceTypeAttribute(1)>
<GuidAttribute("47811DA4-330F-4EB5-9D14-BBC82773DA66")>
Public Interface IVsCoTaskMemFreeMyStrings

Poznámky

COM normální pravidla vyžadují, že jakýkoli řetězec předaný volající by měl být kopie řetězec, který volající nakonec nakládá s.Jinými slovy volající je uveden řetězec vlastnictví a lze nakládat řetězce při odpověděl volajícího.

Některá rozhraní v Visual Studio rozšíření místa není dodržovat tato pravidla předávání vlastnictví volajícímu z důvodů výkonu.Volající tyto speciální rozhraní pochopit tuto změnu v pravidle a nepokoušejte se nakládat řetězce.Však ve spravovaném kódu deklarace parametru vráceného řetězce v těchto zvláštních rozhraní neznamená vždy předávání vlastnictví řetězec volajícímu.

Spravovaný kód by měl provádět IVsCoTaskMemFreeMyStrings rozhraní v těchto specifických rozhraních označíte, že řetězec skutečně by uvolněna volajícího; jinak volající zdarma není řetězec.

Poznámky pro implementátory:

Implementujte toto rozhraní na stejné rozhraní, které obsahují následující metody.Implementace rozhraní označuje, že řetězec vrácený z následujících metod odbyt volajícího; jinak řetězec není vyřazen.

GetText(IVsLiteTreeList rozhraní)
GetTipText(IVsLiteTreeList rozhraní)
GetSourceContext(IVsObjectList rozhraní)
GetText(IVsObjectList rozhraní)
GetNameAt(IVsLibraryMgr rozhraní)
GetSeparatorString(IVsLibrary rozhraní)
GetDisplayText(IVsCompletionSet rozhraní)
FullTextRead(IVsFullTextScanner rozhraní)
Read(IVsTextScanner rozhraní)
GetEntryText(IVsDropdownBarClient rozhraní)
Image_FullTextRead(IVsPersistentTextImage rozhraní)

Poznámky pro volající:

Bez správy volací kód do spravovaného kódu pro jednu z metod v poznámky pro implementátory části seznamu volání QueryInterface metoda rozhraní, které obsahuje metodu získání IVsCoTaskMemFreeMyStrings rozhraní.Pokud IVsCoTaskMemFreeMyStrings lze získat rozhraní, zodpovídáte za uvolnění řetězec voláním FreeCoTaskMem funkce (není SysFreeString funkci).Pokud nelze získat IVsCoTaskMemFreeMyStrings rozhraní, nepokoušejte se uvolnit vráceného řetězce.

Viz také

Microsoft.VisualStudio.Shell.Interop – obor názvů

Zpátky na začátek

Sdílet prostřednictvím