Supplicant API Çağrı Dizisi
Bu konu, ilgili API için belirli bir çağrı dizisi sağlar.
Supplicant API Çağrı Dizisine Genel Bakış
Destekçi bir sağlayıcıdan erişim noktası gibi bir EAP paketi aldığında genellikle aşağıdaki destek api çağrı akışı gerçekleşir.
- Uygulama, EAPHost yapılandırma verileri ve kullanıcı verileriyle EapHostPeerBeginSession çağırır. Başarılı bir çağrı bir EAP_SESSION_HANDLE oturumu tanıtıcısı döndürür.
- destekleyici tarafından alınan her paket, EapHostPeerProcessReceivedPacketçağrısıyla işlenir. Bundan sonra yardımcı, işlevin döndürdiği eylem koduna karşılık gelen işlevi çağırır.
- Eylem kodu EapHostPeerResponseSend ise, doğrulayıcıya gönderilecek yanıtı almak için yardımcı EapHostPeerGetSendPacketçağırır.
- Oturum sırasında destek öğesine döndürülen eylem kodu EapHostPeerResponseRespond ise, EAP özniteliklerinin kullanılabilir olduğunu gösterir. Bundan sonra supplicant EapHostPeerGetResponseAttributes çağırarak bunları alır. Bu öznitelikler, kimlik doğrulama işlemi sırasında kullanılan ek verileri içerir. Supplicant çağırdığı öznitelikleri işlemeyi tamamladıktan sonra verileri güncelleştiren EapHostPeerSetResponseAttributes. Bu işlev, yardımcının sonraki eylemini belirleyen bir eylem kodu döndürür.
- Eylem kodu EapHostPeerResponseInvokeUI , kullanıcıdan kimlik bilgileri veya kimlik bilgileri gibi etkileşimli veriler almak için bir kullanıcı arabirimi iletişim kutusu oluşturur. Aşağıdaki Destek API Çağrı Akışı ile Kullanıcı Etkileşimi bölümüne bakın.
- Eylem kodu EapHostPeerResponseResult ise, kimlik doğrulama oturumunun sonuçlarının uygun olduğunu gösterir. Ardından supplicant, sonuçları almak için EapHostPeerGetResultçağırır. Sonuçların başarılı veya başarısız olup olmadığına bakılmaksızın, supplicant EapHostPeerEndSessionçağırır. Hata durumunda, EAPHost ile başka bir oturum açıp yeni bir kimlik sağlayarak veya özgün kimlikle kimlik doğrulaması yeniden denenerek yeniden kimlik doğrulaması denenebilir.
Ekli API Çağrı Akışı ile Kullanıcı Etkileşimi
Bazı durumlarda, destek biriminin kimlik doğrulama işlemine devam etmek için kullanıcıdan bilgi alması gerekir.
Aşağıdaki listede, etkileşimli girişi etkinleştirmek için gerekli olan supplicant ve EAPHost UI işlemindeki çağrıların dizisi gösterilmektedir.
destekleyici, EapHostPeerGetUIContextçağırarak geçerli kullanıcı arabirimi bağlamını alır.
Ardından, ilgili kullanıcı arabirimi bağlam verilerini ilgili kullanıcı arabirimi işlemine gönderir.
Not
Genellikle kullanıcı arabirimini toplayan veya etkileşimli kullanıcı arabirimini işleyen kullanıcı arabirimi işlemi, ilgili işlemden ayrıdır. İki işlemi ayırmak EAPHost'un bir gereksinimi değildir, ancak bunu yapmak kullanıcı arabirimi işleminin masaüstüyle etkileşim kurmasına izin verme avantajına sahiptir.
Yardımcı kullanıcı arabirimini tek başına işlemek istiyorsa, oluşturulacak etkileşimli UI bileşenlerinin giriş alanlarını almak için EapHostPeerQueryInteractiveUIInputFields işlevini çağırır. Aksi takdirde, EapHostPeerInvokeInteractiveUI çağırarak geleneksel yöntem etkileşimli kullanıcı arabirimini çağırma modelini izler
Not
EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED döndürülürse, EapHostPeerInvokeInteractiveUIçağırarak istek sahibinin geleneksel yöntem etkileşimli kullanıcı arabirimini çağırma modelini izlemesi gerekir. Hata varsa, EapHostPeerQueryInteractiveUIInputFieldsNULLdışında bir dönüş kodu döndürür.
Yardımcının EapHostPeerQueryInteractiveUIInputFields veya EaphostPeerInvokeInteractiveUI çağırıp çağırmadığını ui işlemi mevcut bağlam verilerini geçirir ve Eappcfg.dllyükler. Yeni verileri toplamak için uygun kullanıcı arabirimi oluşturulur. Artık kullanıcı girişi içerebilen yeni kullanıcı arabirimi bağlam verileri kopyalanır ve eski bağlam verileri EapPeerFreeMemoryçağrısıyla yayımlanır.
UI işlemi, yeni bağlam verilerini EapHostPeerSetUIContext çağırarak bunu ayarlayan destek birimine döndürür.
İlgili konular