NPPasswordChangeNotify-Funktion (npapi.h)

Artikel
08/25/2023

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

Freigeben über