PWLX_QUERY_CLIENT_CREDENTIALS回呼函式 (winwlx.h)

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

如果啟用終端機服務，則會由取代 GINA DLL 呼叫 WlxQueryClientCredentials 函式。

注意 Windows Vista 中會忽略 GINA DLL。

GINA 會呼叫此函式，以擷取未使用因特網連接器授權的遠端終端機服務客戶端認證。

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

語法

PWLX_QUERY_CLIENT_CREDENTIALS PwlxQueryClientCredentials;

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

[out] pCred

指定傳回時包含客戶端認證的 WLX_CLIENT_CREDENTIALS_INFO_V1_0 結構的指標。

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

傳回碼	Description
TRUE	已擷取認證資訊，並在 pCred 中傳回。
FALSE	未擷取認證資訊。

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

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

如果終端機服務用戶端使用因特網連接器授權，GINA DLL 必須呼叫 WlxQueryInetConnectorCredentials。

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