WlxInitialize 関数 (winwlx.h)

  • [アーティクル]

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

WlxInitialize 関数は、代替の GINA DLL によって実装される必要があります。 Winlogon は 、コンピューター上に存在するウィンドウ ステーションごとにこの関数を 1 回呼び出します。 現在、オペレーティング システムはワークステーションごとに 1 つのウィンドウ ステーションをサポートしています。

メモ Windows Vista では GINA DLL は無視されます。
 
この関数によって返される コンテキスト は、後続のすべての呼び出しで GINA に返されます。

構文

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を指定する必要があります。

値 意味
WLX_DISPATCH_VERSION_1_4
 Winlogon ディスパッチ テーブル - バージョン 1.4
WLX_DISPATCH_VERSION_1_3
 Winlogon ディスパッチ テーブル - バージョン 1.3
WLX_DISPATCH_VERSION_1_2
 Winlogon ディスパッチ テーブル - バージョン 1.2
WLX_DISPATCH_VERSION_1_1
 Winlogondispatch テーブル - バージョン 1.1
WLX_DISPATCH_VERSION_1_0
 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

こちらもご覧ください

WlxNegotiate