Win32 API 日本語リファレンス
ホーム › Security.WinWlx › PWLX_QUERY_CLIENT_CREDENTIALS

PWLX_QUERY_CLIENT_CREDENTIALS

コールバック

シグネチャ

BOOL PWLX_QUERY_CLIENT_CREDENTIALS(
    WLX_CLIENT_CREDENTIALS_INFO_V1_0* pCred
);

パラメーター

フィールド型説明
pCredWLX_CLIENT_CREDENTIALS_INFO_V1_0*戻り時にクライアントの資格情報が格納される WLX_CLIENT_CREDENTIALS_INFO_V1_0 構造体へのポインターを指定します。

公式ドキュメント

[WlxQueryClientCredentials 関数は、Windows Server 2008 および Windows Vista 以降では使用できません。]

WlxQueryClientCredentials 関数は、Terminal Services が有効な場合に置き換え用の GINA DLL から呼び出されます。

メモ GINA DLL は Windows Vista では無視されます。
GINA は、インターネット コネクタ ライセンスを使用していないリモート Terminal Services クライアントの資格情報を取得するために、この関数を呼び出します。

GINA DLL はこの情報を利用して、ログオン ボックスに自動的に値を設定し、ユーザーのログオンを試行できます。

戻り値

WlxQueryClientCredentials 関数は、次のいずれかの値を返します。

戻り値 説明
TRUE
資格情報が取得され、pCred に返されました。
FALSE
資格情報を取得できませんでした。

解説(Remarks)

この構造体が不要になったときに、 LocalFree を呼び出して、この構造体が使用しているリソースを解放するのは GINA DLL の役割です。

この関数にアクセスするには、GINA DLL は WLX_DISPATCH_VERSION_1_3 構造体を使用し、 WlxNegotiate の呼び出しで Winlogon のバージョンを少なくとも WLX_VERSION_1_3 に設定する必要があります。

Terminal Services クライアントがインターネット コネクタ ライセンスを使用している場合、GINA DLL は WlxQueryInetConnectorCredentials を呼び出す必要があります。

Terminal Services が有効な場合に呼び出される可能性のあるその他の Winlogon サポート関数には、WlxDisconnect、WlxQueryInetConnectorCredentials、WlxWin31Migrate があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)