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

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

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

メモ Windows Vista では GINA DLL は無視されます。

その後、GINA DLL は、この情報を使用してログオンボックスに自動的に入力し、ユーザーのログインを試みます。

構文

PWLX_QUERY_IC_CREDENTIALS PwlxQueryIcCredentials;

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

[out] pCred

戻り値が TRUE の場合、 pCred は、自動ログオンに使用する資格情報を含む WLX_CLIENT_CREDENTIALS_INFO_V1_0 構造体へのポインターを指定します。

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

リターンコード	説明
TRUE	インターネットコネクタのライセンスが有効になっています。
FALSE	インターネットコネクタのライセンスは使用できません。

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

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

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

ターミナルサービスが有効になっているときに呼び出される可能性があるその他の Winlogon サポート関数は、 WlxDisconnect、 WlxQueryClientCredentials、 WlxQueryTerminalServicesData 、 WlxWin31Migrate です。