WlxNegotiate-Funktion (winwlx.h)
[Die WlxNegotiate-Funktion ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]
Die WlxNegotiate-Funktion muss von einer GINA-Ersatz-DLL implementiert werden. Dies ist der erste Aufruf von Winlogon an die GINA-DLL. Mit WlxNegotiate kann die GINA überprüfen, ob sie die installierte Version von Winlogon unterstützt.
Syntax
BOOL WlxNegotiate(
[in] DWORD dwWinlogonVersion,
[out] PDWORD pdwDllVersion
);
Parameter
[in] dwWinlogonVersion
Gibt an, welche Winlogon-Version mit der GINA kommuniziert.
[out] pdwDllVersion
Gibt an, welche Winlogon-Version von der GINA unterstützt wird. Diese Versionsinformationen werden auch von Winlogon verwendet, um zu bestimmen, welche Dispatchtabelle bei nachfolgenden Aufrufen von WlxInitialize an die GINA übergeben wird. Diese Version darf nicht größer als die von dwWinLogonVersion angegebene Version sein.
Rückgabewert
Wenn die von dwWinLogonVersion angegebene Winlogon-Version größer oder gleich der in pdwDllVersion zurückgegebenen Version ist, gibt die Funktion TRUE zurück. Wenn TRUE zurückgegeben wird, wird Winlogon weiterhin initialisiert.
Wenn dwWinLogonVersion kleiner als pdwDllVersion ist, gibt die Funktion FALSE zurück. Wenn FALSE zurückgegeben wird, wird Winlogon beendet, und das System wird nicht gestartet.
Hinweise
Vor dem Aufrufen von WlxNegotiate legt Winlogon den Desktopstatus so fest, dass der aktuelle Desktop der Winlogon-Desktop ist, und legt den Arbeitsstationsstatus so fest, dass der Desktop gesperrt ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winwlx.h |