Ogólna składnia wiersza polecenia MIDL
Kompilator MIDL przetwarza plik IDL i opcjonalny plik konfiguracji aplikacji (ACF), aby wygenerować zestaw plików wyjściowych. Atrybuty określone na liście atrybutów interfejsu pliku IDL określają, czy kompilator generuje pliki źródłowe dla interfejsu RPC, czy dla niestandardowego interfejsu OLE.
Opcje przełącznika
midl [command-line-switch [switch-options]] filename
-
przełącznika wiersza polecenia
-
Określa przełączniki wiersza polecenia kompilatora MIDL. Przełączniki mogą być wyświetlane w dowolnej sekwencji.
-
opcji przełącznika
-
Określa opcje skojarzone z każdym przełącznikiem. Prawidłowe opcje opisano we wpisie referencyjnym dla każdego przełącznika kompilatora MIDL.
-
nazwy pliku
-
Określa nazwę pliku IDL. Ten plik ma zwykle rozszerzenie .idl, ale może mieć inny lub żaden.
Uwagi
Na poniższych listach przedstawiono domyślne nazwy plików wygenerowanych dla pliku IDL o nazwie Name.idl. Aby zastąpić te nazwy domyślne, można użyć przełączników wiersza polecenia. Należy pamiętać, że nazwa pliku IDL może mieć rozszerzenie inne niż .idl lub żadne rozszerzenie w ogóle.
Domyślnie (czyli jeśli lista atrybutów interfejsu nie zawiera obiektu lub lokalnego atrybutu), kompilator generuje następujące pliki dla interfejsu RPC:
- Wycink klienta (name_c.c)
- Wycinkę serwera (name_s.c)
- Plik nagłówka (nazwa.h)
Gdy atrybutobiektupojawi się na liście atrybutów interfejsu, kompilator generuje następujące pliki dla interfejsu COM:
- Plik serwera proxy interfejsu (name_p.c)
- Plik nagłówka interfejsu (nazwa.h)
- Plik UUID interfejsu (name_I.c)
Gdy atrybutlokalnegopojawi się na liście atrybutów interfejsu, kompilator generuje tylko plik nagłówka interfejsu Name.h.
Kompilator MIDL dostarczany z usługą Microsoft RPC wywołuje preprocesor języka C zgodnie z potrzebami w celu przetworzenia pliku IDL. Nie wywołuje on automatycznie kompilatora języka C w celu skompilowania wygenerowanych plików.
Nuta
Kompilator MIDL dostarczany z programem Microsoft RPC używa innej składni wiersza polecenia niż kompilator IDL DCE.
Kompilator MIDL przełącza /env, /server, /sstubi /out wpływać na plik wycinków serwera.
Począwszy od wersji MIDL 6.0.359, domyślną opcją wiersza polecenia dla kompilatora MIDL jest /Oicf /robust. Aby wyłączyć /robust, określ opcję /no_robust.
Plik nagłówka
Plik nagłówkowy zawiera definicje wszystkich typów danych i operacji zadeklarowanych w pliku IDL. Plik nagłówka musi być dołączony przez wszystkie moduły aplikacji, które nazywają zdefiniowane operacje, implementują zdefiniowane operacje lub manipulują zdefiniowanymi typami.
Kompilator MIDL przełącza /header i /out wpływać na plik nagłówka.