ActiveDirectoryAuthenticationProvider.SetParentActivityOrWindowFunc 方法

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.Extensions.Azure.dll

套件:

Microsoft.Data.SqlClient.Extensions.Azure v7.1.0

設定一個函式，回傳父視窗的 handle ，用於 WAM（Windows Account Manager）經紀人認證提示。

public:
 void SetParentActivityOrWindowFunc(Func<System::Object ^> ^ parentActivityOrWindowFunc);

public void SetParentActivityOrWindowFunc(Func<object>? parentActivityOrWindowFunc);

member this.SetParentActivityOrWindowFunc : Func<obj> -> unit

Public Sub SetParentActivityOrWindowFunc (parentActivityOrWindowFunc As Func(Of Object))

參數

parentActivityOrWindowFunc

Func<Object>

一個函式，回傳 MSAL 用於互動式認證 UI 的父視窗/活動物件。 在 Windows 上，回傳IntPtr一個視窗句柄（或 IWin32Window .NET 框架）。 在 Android 上，回傳一個活動;在 iOS 上，回傳 UIViewController（或該平台等效物）。 通過 null 以清除先前安裝的回撥，並回復到提供者的預設行為。

備註

在 Windows 上，這個句柄用來控制 WAM 代理對話框的子碼。 若未設定，服務提供者將嘗試自動偵測主控台視窗的句柄。 在非 Windows 平台上，此回調會轉發至 MSAL，讓互動式流程能將其 UI 父權設定為主機活動/UIViewController（或平台等效物）。

MSAL 呼叫時拋出 parentActivityOrWindowFunc 的例外不會被提供者捕捉;這些異常會傳達給原始 AcquireToken 請求的呼叫者，使回撥中的錯誤在最容易被診斷的地方浮現。