Aracılığıyla paylaş

MIDL kullanma

RPC kullanan programlara yönelik tüm arabirimler Microsoft Arabirim Tanım Dili'nde (MIDL) tanımlanmalı ve MIDL derleyicisi ile derlenmelidir. Aşağıdaki konular, MIDL arabirimi oluşturma ve derlemeye yönelik kısa bir genel bakış sunar:

Bu konuların ayrıntılı bir tartışması için bkz. IDL ve ACF Dosyaları .

MIDL ile Arabirim Tanımlama

MIDL dosyaları, bir metin düzenleyicisiyle oluşturabileceğiniz ve düzenleyebileceğiniz metin dosyalarıdır. Arabiriminiz için bir UUID oluşturursanız, genellikle çıkışı bir şablon MIDL dosyasında depolarsınız. UUID'ler hakkında daha fazla bilgi için bkz. Arabirim UUID'leri oluşturma.

MIDL'deki tüm arabirimler aynı biçimi izler. Bunlar, arabirim özniteliklerinin listesini ve arabirim adını içeren bir üst bilgiyle başlar. Öznitelikler köşeli ayraçlar içine yerleştirilir. Arabirim başlığı, süslü parantezler içine alınmış gövdeyi takip eder. Aşağıdaki örnekte basit bir arabirim gösterilmiştir:

[
  uuid(ba209999-0c6c-11d2-97cf-00c04f8eea45),
  version(1.0)
]
interface MyInterface
{
  const unsigned short INT_ARRAY_LEN = 100;

  void MyRemoteProc( 
      [in] int param1,
      [out] int outArray[INT_ARRAY_LEN]
  );
}

Genellikle MIDL arabirim tanımında görünen özniteliklerden bazıları UUID ve arabirim sürüm numarasıdır. Arabirim tanımının gövdesi, arabirimdeki tüm uzak yordamların yordam bildirimlerini içermelidir. Ayrıca, arabirim için gereken veri türlerinin ve sabitlerin bildirimlerini de içerebilir.

Uzak yordam bildirimlerindeki tüm parametreler [in], [out], veya [in, out] olarak bildirilmelidir. Bu bildirimler, istemci programının verileri bir uzak yordama geçirmesini, uzak yordamdan veri almasını veya her ikisini birden belirtmesini sağlar. Arabirim parametresi bildirimleri hakkında daha ayrıntılı bilgi için bkz. IDL Arabirim Gövdesi.

MIDL Dosyası Derleme

MIDL derleyicisi, Platform Yazılım Geliştirme Seti (SDK) ile otomatik olarak yüklenen bir komut satırı aracıdır. Komut penceresinde midl komutunu ve ardından komut satırına midl dosyasının adını yazarak bunu çağırın. MIDL derleyicisini içeren dizinin yolunuzda olduğundan emin olun. Aşağıdaki örnekte kullanımı gösterilmektedir:

midl MyApp.idl

Dosya adında .idl uzantısı varsa uzantıyı eklemeniz gerekmediğini unutmayın. midl komutuyla dosya adı arasına ekleyerek MIDL derleyici komut satırı anahtarlarını da kullanabilirsiniz. Bu, aşağıdaki örnekte gösterilmiştir:

midl /acf MyApp.acf MyApp.idl

Bu örnekte MIDL derleyicisi, giriş dosyası olarak MyApp.idl dosyası kullanılarak yürütülür. /acf komut satırı anahtarı, derleyiciye giriş için bir uygulama yapılandırma dosyası (ACF) kullanmasını da ister. Uygulama yapılandırma dosyaları, IDL ve ACF Dosyalarıbaşlığında daha ayrıntılı bir şekilde ele alınıyor.

MIDL derleyicisini kullanma hakkında daha ayrıntılı bilgi için, aşağıdaki konular hakkında bilgi içeren Microsoft Arabirim Tanımlama Dili (MIDL)bakın:

 

 

  • Last updated on