PWLX_QUERY_CLIENT_CREDENTIALS コールバック関数 (winwlx.h)
[WlxQueryClientCredentials 関数は、Windows Server 2008 および Windows Vista では使用できなくなりました。
ターミナル サービスが有効になっている場合、 WlxQueryClientCredentials 関数は置換 GINA DLL によって呼び出されます。
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 関数は、次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
資格情報の情報が取得され、 pCred で返されました。 |
|
資格情報の情報が取得されませんでした。 |
注釈
GINA DLL は、 LocalFree を呼び出して、構造体が不要になったときにこの構造体で使用されるリソースを解放する役割を担います。
この関数にアクセスするには、GINA DLL で WLX_DISPATCH_VERSION_1_3 構造体を使用し、Winlogon バージョンを WlxNegotiate 呼び出しで少なくともWLX_VERSION_1_3に設定する必要があります。
ターミナル サービス クライアントがインターネット コネクタ ライセンスを使用している場合、GINA DLL は WlxQueryInetConnectorCredentials を呼び出す必要があります。
ターミナル サービスが有効になっているときに呼び出される可能性があるその他の Winlogon サポート関数は、 WlxDisconnect、 WlxQueryInetConnectorCredentials、 WlxWin31Migrate です。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | winwlx.h |