Atrybuty interfejsu

  • Artykuł

Następujące atrybuty dotyczą interfejsu (lub __interface) słowa kluczowego C++.

Atrybut opis
async_uuid Określa identyfikator UUID, który kieruje kompilator MIDL do definiowania zarówno synchronicznych, jak i asynchronicznych wersji interfejsu COM.
custom Umożliwia definiowanie własnych atrybutów.
dispinterface Umieszcza interfejs w pliku idl jako interfejs wysyłania.
dual Umieszcza interfejs w pliku idl jako podwójny interfejs.
export Powoduje umieszczenie struktury danych w pliku idl.
helpcontext Określa identyfikator kontekstu, który umożliwia użytkownikowi wyświetlanie informacji o tym elemecie w pliku Pomocy.
helpfile Ustawia nazwę pliku Pomocy dla biblioteki typów.
helpstring Określa ciąg znaków używany do opisywania elementu, do którego ma on zastosowanie.
helpstringcontext Określa identyfikator tematu pomocy w pliku hlp lub chm.
helpstringdll Określa nazwę biblioteki DLL, która ma być używana do wykonywania wyszukiwania ciągów dokumentu (lokalizacja).
hidden Wskazuje, że element istnieje, ale nie powinien być wyświetlany w przeglądarce zorientowanej na użytkownika.
library_block Umieszcza konstrukcję wewnątrz bloku biblioteki pliku idl.
local Umożliwia użycie kompilatora MIDL jako generatora nagłówków, gdy jest używany w nagłówku interfejsu. W przypadku użycia w pojedynczej funkcji wyznacza procedurę lokalną, dla której nie są generowane wycinki.
nonextensible Określa, że implementacja IDispatch zawiera tylko właściwości i metody wymienione w opisie interfejsu i nie można go rozszerzyć z dodatkowymi elementami członkowskimi w czasie wykonywania. Ten atrybut jest prawidłowy tylko w przypadku podwójnego interfejsu.
odl Identyfikuje interfejs jako interfejs ODL (Object Description Language).
object Identyfikuje interfejs niestandardowy.
oleautomation Wskazuje, że interfejs jest zgodny z usługą Automation.
pointer_default Określa domyślny atrybut wskaźnika dla wszystkich wskaźników z wyjątkiem wskaźników najwyższego poziomu, które są wyświetlane na listach parametrów.
ptr Wyznacza wskaźnik jako pełny wskaźnik.
restricted Wyznacza, których elementów członkowskich biblioteki nie można nazwać dowolnie.
uuid Udostępnia unikatowy identyfikator biblioteki

Należy przestrzegać tych reguł definiowania interfejsu:

  • Domyślna konwencja wywoływania jest __stdcall.

  • Jeśli go nie podasz, zostanie podany identyfikator GUID.

  • Metody przeciążone nie są dozwolone.

Jeśli nie określisz atrybutu uuid i użyjemy tej samej nazwy interfejsu w różnych projektach atrybutów, zostanie wygenerowany ten sam identyfikator GUID.

Zobacz też

Atrybuty w zależności od zastosowania