PWLX_QUERY_CLIENT_CREDENTIALS コールバック関数 (winwlx.h)

[WlxQueryClientCredentials 関数は、Windows Server 2008 および Windows Vista では使用できなくなりました。

ターミナルサービスが有効になっている場合、 WlxQueryClientCredentials 関数は置換 GINA DLL によって呼び出されます。

メモ 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 関数は、次のいずれかの値を返します。

リターンコード	説明
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 です。