Aracılığıyla paylaş

Arabirim Vekil Dosyası

  • Makale

Arabirim proxy dosyası (U_p.c), bir nesne (COM) arabiriminin istemci saplama ve sunucu saptama dosyalarındakilere eşdeğer yordamlar içeren bir C dosyasıdır. Bu dosya, derleyicinin satır içi modunda istemci ve sunucu için aracı rutinlerin uygulamalarını veya yorumlanan modlardaki eşdeğer veri ve ara yordamların yanı sıra, vekil ve saplama Vtable'ları gibi diğer uygun COM yapıştırıcı verilerini içerir.

Arabirim proxy dosyası, yalnızca geçerli IDL dosyasında tanımlanan arabirimlerin yöntemleri için destekleyici yordamları ve verileri içerir. Bu davranışı netleştirmek için bu bölümün tamamında genişletilmiş bir örnek kullanılır. IFaceA'dan devralan IFaceB gibi bir arabirime sahip bir IDL dosyası derlenirken, IFaceB ile ilgili yardımcı veriler ve yordamlar geçerli proxy dosyasına oluşturulurken, IFaceA ile ilgili temel arabirim yardımcı veriler ve yordamlar IFaceA tanımını içeren IDL dosyasından oluşturulan proxy'de bulunur. Derleyici, temel arabirimin vekillerini tanımlamak ve IFaceB arabirimi aracılığıyla kullanılan IFaceA yöntemlerini desteklemek için gerektiğinde bunlara temsilci atamak için gereken tüm verileri oluşturur.

Geçerli IDL dosyasındaki bir arabirimdeki her yöntem için, ara sunucu dosyası karma modda derlendiğinde aşağıdaki iki vekil yöntemi (/Os) ve yorumlayıcı modunda derlendiğinde eşdeğer yorumlayıcı verilerini içerir (/Oi).

  • İstemci tarafı vekili, bu örnekte IFaceB_Method_Proxy gibi.

    Bu istemci tarafı vekili, istemcinin, örneğin IFaceB::Method gibi yöntemleri yönlendirdiği sanal giriş noktasıdır. Giriş bağımsız değişkenlerini aktarılabilir bir biçimde düzenler, arabirimi ve işlemi tanımlayan bilgilerle birlikte düzenlenmiş bağımsız değişkenleri iletir ve çağrılan işlem döndüğünde dönüş değerini ve tüm çıkış bağımsız değişkenlerini çözümler.

  • Sunucu tarafı vekili, örneğin IFaceB_Method_Stub.

    Bu sunucu tarafı vekili, temel çalışma zamanı tarafından sunucuya yönlendirilen ve istemciyi taklit eden sanal giriş noktasıdır. İstemci verilerini çoğaltmak için giriş bağımsız değişkenlerini özetler, sunucunun arabirim işlevini uygulamasını çağırır ve sonra dönüş değerini ve çıkış bağımsız değişkenlerini istemci tarafına doğru sıralar ve iletir.

file.idl dosyasından oluşturulan bir proxy dosyasının varsayılan adı file_p.c. Arabirim proxy dosyasının varsayılan adını geçersiz kılmak için /proxy MIDL derleyici anahtarını kullanın. /env ve /out anahtarları bu dosyayı etkiler.