PWLX_QUERY_IC_CREDENTIALS回呼函式 (winwlx.h)

[WlxQueryInetConnectorCredentials 函式已不再可供 Windows Server 2008 和 Windows Vista 使用。]

如果啟用終端機服務，則由取代 GINA DLL 呼叫。 GINA 會呼叫此函式，以判斷終端機伺服器是否使用網際網路連接器授權，以及擷取認證資訊。

注意 Windows Vista 中會忽略 GINA DLL。

GINA DLL 接著可以使用這項資訊自動填入登入方塊，並嘗試登入使用者。

語法

PWLX_QUERY_IC_CREDENTIALS PwlxQueryIcCredentials;

BOOL PwlxQueryIcCredentials(
  [out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}

[out] pCred

當傳回值為 TRUE時， pCred 會指定 WLX_CLIENT_CREDENTIALS_INFO_V1_0 結構的指標，其中包含要用於自動登入的認證。

WlxQueryInetConnectorCredentials函式會傳回下列其中一個值。

傳回碼	描述
TRUE	已啟用網際網路連接器授權。
FALSE	網際網路連接器授權無法使用。

GINA DLL 負責呼叫 LocalFree ，以釋放不再需要結構時此結構所使用的資源。

若要存取此函式，GINA DLL 必須使用 WLX_DISPATCH_VERSION_1_3 結構，並將 Winlogon 版本設定為其 WlxNegotiate 呼叫中至少WLX_VERSION_1_3。

如果終端機服務未使用網際網路連接器授權，GINA DLL 必須呼叫 WlxQueryClientCredentials。

啟用終端機服務時可能會呼叫的其他 Winlogon 支援函式為 WlxDisconnect、 WlxQueryClientCredentials、 WlxQueryTerminalServicesData 和 WlxWin31Migrate。