ICredentialProviderCredentialEvents::OnCreatingWindow 方法 (credentialprovider.h)

创建窗口时调用。 在调用 建议 后,允许凭据检索父窗口的 HWND。

语法

HRESULT OnCreatingWindow(
  [out] HWND *phwndOwner
);

参数

[out] phwndOwner

类型: HWND*

指向父窗口句柄的指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

phwndOwner 中返回的 HWND 可用作对话框的父级,例如消息框。 任何显示对话框的凭据提供程序都必须将其父级提供给 OnCreatingWindow 提供的 HWND。 如果凭据提供程序未正确设置父对话框,将导致凭据 UI 和登录 UI 在发生超时时失败。

如果凭据 UI 和登录 UI 在两分钟内未收到任何输入,则可以取消对话框。 仅当正确分配了指向父窗口的指针时,才会发生超时。

登录 UI 和凭据 UI 将自动取消两分钟未收到任何输入的对话框。 仅当正确分配了指向父窗口的指针时,才可能执行此操作。 在预登录访问提供程序 (PLAP) 屏幕上显示为对 IConnectableCredentialProviderCredentialProviderCredential::Connect 调用的对话永远不会因非活动而取消。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 credentialprovider.h