Atrybuty interfejsu
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.