NPPasswordChangeNotify-Funktion (npapi.h)

  • Artikel

Hinweis

Diese API ist veraltet und wird in einer zukünftigen Version entfernt.

MPR ruft diese Funktion auf, um den Anmeldeinformations-Manager über ein Kennwortänderungsereignis zu benachrichtigen. Die NPPasswordChangeNotify-Funktion wird von einer DLL für den Anmeldeinformations-Manager implementiert.

Syntax

DWORD NPPasswordChangeNotify(
  [in] LPCWSTR lpAuthentInfoType,
  [in] LPVOID  lpAuthentInfo,
  [in] LPCWSTR lpPreviousAuthentInfoType,
  [in] LPVOID  lpPreviousAuthentInfo,
  [in] LPWSTR  lpStationName,
  [in] LPVOID  StationHandle,
  [in] DWORD   dwChangeInfo
);

Parameter

[in] lpAuthentInfoType

Zeiger auf eine Zeichenfolge, die den Typ der Struktur identifiziert, auf die von lpAuthentInfo verwiesen wird.

Wenn Microsoft der primäre Authentifikator ist, wird die folgende Zeichenfolge für interaktive Und Dienstcontrolleranmeldungen angegeben.

MSV1_0:Interactive 
Kerberos:Interactive

[in] lpAuthentInfo

Zeiger auf eine Struktur, die die neuen Anmeldeinformationen enthält.

Wenn Microsoft der primäre AuthentifoType ist (d. h. wenn lpAuthentifoType "MSV1_0:Interactive" oder "Kerberos:Interactive" ist), wird die verwendete Struktur MSV1_0_INTERACTIVE_LOGON oder KERB_INTERACTIVE_LOGON.

[in] lpPreviousAuthentInfoType

Zeiger auf eine Zeichenfolge, die den Strukturtyp identifiziert, auf den von lpPreviousAuthentInfo verwiesen wird. Wenn der Zeiger NULL ist, gab es keine vorherigen Informationen. Die hier erwarteten Werte sind mit denen in lpAuthentInfoType identisch.

Wenn Microsoft der primäre Authentifikator ist, wird die folgende Zeichenfolge für interaktive Und Dienstcontrolleranmeldungen angegeben.

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

Zeiger auf eine Struktur, die die Anmeldeinformationen enthält, die vor der Änderung der Authentifizierungsinformationen verwendet wurden. Vorherige Informationen werden bereitgestellt, wenn der Benutzer vor der Anmeldung gezwungen wurde, das Kennwort (oder andere Authentifizierungsinformationen) zu ändern. Wenn der Benutzer nicht gezwungen wurde, die Authentifizierungsinformationen zu ändern, lautet dieser Zeiger NULL. Die hier erwarteten Werte entsprechen denen in lpAuthentInfo.

Wenn Microsoft der primäre Authentifikator ist, wird die verwendete Struktur MSV1_0_INTERACTIVE_LOGON oder KERB_INTERACTIVE_LOGON.

[in] lpStationName

Zeiger auf eine Zeichenfolge, die den Namen der Station angibt, bei der sich der Benutzer angemeldet hat. Der Stationsname kann verwendet werden, um zu bestimmen, ob zusätzliche anbieterspezifische Informationen abgerufen werden können.

Wenn Microsoft der primäre Authentifikator ist, wird eine der folgenden Zeichenfolgen angegeben.

Wert Bedeutung
WinSta_0
 Gibt an, dass dies eine interaktive Anmeldung über die Fensterstation ist. In diesem Fall ist StationHandle ein HWND für das übergeordnete Dialogfeld.
SvcCtl
 Gibt an, dass es sich um eine vom Dienstcontroller initiierte Anmeldung handelt. StationHandle wird in diesem Fall nicht verwendet.

[in] StationHandle

Ein 32-Bit-Wert, dessen Bedeutung vom Namen (und folglich vom Typ) der station abhängig ist, die in lpStationName angegeben ist.

Wert Bedeutung
WinSta_0
 Ein Handle für das Dialogfeld "Besitzer" (hwndOwner), das derzeit auf dem Bildschirm angezeigt wird.
SvcCtl
 Zufällige Daten. Nicht verwenden.

[in] dwChangeInfo

Wenn festgelegt, gibt ein Flag an, das Änderungsinformationen bereitstellt. Dieser Parameter kann eines der Flags sein.

Wert Bedeutung
WN_VALID_LOGON_ACCOUNT
 Dieses Flag gibt an, dass sich die geänderten Authentifizierungsinformationen auf alle zukünftigen Anmeldungen auswirken. Der Benutzer gehört zu einer vertrauenswürdigen Domäne.
WN_NT_PASSWORD_CHANGED
 Dieses Flag gibt an, dass das Kennwort geändert wurde.

Einige Änderungen an Authentifizierungsinformationen wirken sich nur auf Verbindungen aus nicht vertrauenswürdigen Domänen aus. Dies sind die Konten, die der Benutzer nicht verwenden kann, um sich bei diesem Computer anzumelden. In diesen Fällen ist dwChangeInfo nicht festgelegt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion WN_SUCCESS zurück.

Wenn die Funktion fehlschlägt, gibt sie einen Fehlercode zurück, bei dem es sich um einen der folgenden Werte handeln kann.

Rückgabecode Beschreibung
WN_NOT_SUPPORTED

NPPasswordChangeNotify wird nicht unterstützt.
WN_NO_NETWORK
 Das Netzwerk ist nicht vorhanden.
WN_FUNCTION_BUSY
 Der Anmeldeinformations-Manager initialisiert weiterhin und kann nicht aufgerufen werden.

Hinweise

Die NPPasswordChangeNotify-Funktion wird von Anmeldeinformations-Managern implementiert, um Benachrichtigungen zu empfangen, wenn sich die Authentifizierungsinformationen ändern.

Windows Server 2003 und Windows XP: NPPasswordChangeNotify wird auf einem Computer aufgerufen, bei dem sich ein Benutzer anmeldet, wenn das Kennwort an anderer Stelle geändert wurde. Beachten Sie, dass dieses Verhalten ab Windows Vista und Windows Server 2008 nicht unterstützt wird.

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 npapi.h

Weitere Informationen

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify