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

PWLX_QUERY_IC_CREDENTIALS

コールバック

シグネチャ

BOOL PWLX_QUERY_IC_CREDENTIALS(
    WLX_CLIENT_CREDENTIALS_INFO_V1_0* pCred
);

パラメーター

フィールド型説明
pCredWLX_CLIENT_CREDENTIALS_INFO_V1_0*戻り値が TRUE の場合、pCred には、自動ログオンに使用する資格情報を格納した WLX_CLIENT_CREDENTIALS_INFO_V1_0 構造体へのポインターを指定します。

公式ドキュメント

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

Terminal Services が有効な場合に、置き換え用の GINA DLL から呼び出されます。 GINA は、ターミナル サーバーがインターネット コネクタ ライセンスを使用しているかどうかを判断し、資格情報を取得するために、この関数を呼び出します。

メモ GINA DLL は Windows Vista では無視されます。
GINA DLL は、この情報を使用してログオン ボックスを自動的に入力し、ユーザーのログオンを試行できます。

戻り値

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

戻り値 説明
TRUE
インターネット コネクタ ライセンスが有効です。
FALSE
インターネット コネクタ ライセンスは利用できません。

解説(Remarks)

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

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

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

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

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