WlxInitialize 関数 (winwlx.h)
[WlxInitialize 関数は、Windows Server 2008 および Windows Vista では使用できなくなりました。
WlxInitialize 関数は、代替の GINA DLL によって実装される必要があります。 Winlogon は 、コンピューター上に存在するウィンドウ ステーションごとにこの関数を 1 回呼び出します。 現在、オペレーティング システムはワークステーションごとに 1 つのウィンドウ ステーションをサポートしています。
構文
BOOL WlxInitialize(
[in] LPWSTR lpWinsta,
[in] HANDLE hWlx,
[in] PVOID pvReserved,
[in] PVOID pWinlogonFunctions,
[out] PVOID *pWlxContext
);
パラメーター
[in] lpWinsta
初期化中のウィンドウ ステーションの名前へのポインター。
[in] hWlx
Winlogon へのハンドル。 GINA は、このウィンドウ ステーションを含む Winlogon サポート関数のすべての呼び出しで、このハンドルを指定する必要があります。
[in] pvReserved
このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。
[in] pWinlogonFunctions
Winlogon サポート関数ディスパッチ テーブルへのポインター。 テーブルの内容は、 WlxNegotiate 呼び出しによって返される GINA DLL バージョンによって異なります。 このテーブルは変更されません。これにより、GINA DLL はテーブルをコピーせずに参照できます。 GINA DLL でテーブルのコピーを作成する必要がある場合は、 WlxGetOption を呼び出し、 Option パラメーターのWLX_OPTION_DISPATCH_TABLE_SIZEを指定する必要があります。
| 値 | 意味 |
|---|---|
| Winlogon ディスパッチ テーブル - バージョン 1.4 | |
| Winlogon ディスパッチ テーブル - バージョン 1.3 | |
| Winlogon ディスパッチ テーブル - バージョン 1.2 | |
| Winlogondispatch テーブル - バージョン 1.1 | |
| Winlogon ディスパッチ テーブル - バージョン 1.0 |
[out] pWlxContext
このウィンドウ ステーションの GINA コンテキストのアドレスを含む VOID へのポインターへのポインター。 このコンテキストは、Winlogon から GINA への後続のすべての呼び出しで渡されます。 GINA DLL は、コンテキストで使用されるすべてのメモリを管理します。 コンテキスト ポインターは、後で WLX_OPTION_CONTEXT_POINTER を使用して WlxSetOption 関数を呼び出すことによって変更できます。
戻り値
関数が GINA DLL を正常に初期化すると、関数は TRUE を返します。
関数が失敗した場合、または GINA DLL が初期化されていない場合、関数は FALSE を返します。 Winlogon は終了し、システムは起動しません。
注釈
WlxInitialize は、コンピューター上に存在するウィンドウ ステーションごとに 1 回呼び出されます。
現在、Winsta0 と呼ばれる 1 つのウィンドウ ステーションのみがサポートされています。
WlxInitialize を呼び出す前に、Winlogon はデスクトップの状態を設定して、現在のデスクトップが Winlogon デスクトップになるようにし、デスクトップがロックされるようにワークステーションの状態を設定します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | winwlx.h |