共用方式為

NPPasswordChangeNotify 函式 (npapi.h)

  • 發行項

注意

此 API 已被取代，將在未來的版本中移除。

MPR 會呼叫此函式，以通知認證管理員密碼變更事件。 NPPasswordChangeNotify 函式是由認證管理員 DLL 實作。

語法

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

參數

[in] lpAuthentInfoType

字串的指標，識別 lpAuthentInfo 所指向的結構類型。

當 Microsoft 是主要驗證器時，會針對互動式和服務控制器登入指定下列字串。

MSV1_0:Interactive 
Kerberos:Interactive

[in] lpAuthentInfo

包含新認證的結構指標。

當 Microsoft 是主要驗證器 (，也就是當 lpAuthentifoType 為 “MSV1_0：Interactive” 或 “Kerberos：Interactive”) 時，所使用的結構會 MSV1_0_INTERACTIVE_LOGON 或 KERB_INTERACTIVE_LOGON。

[in] lpPreviousAuthentInfoType

字串的指標，識別 lpPreviousAuthentInfo 所指向的結構類型。 如果指標為 NULL，則沒有先前的資訊。 此處預期的值與 lpAuthentInfoType 中的值相同。

當 Microsoft 是主要驗證器時，會針對互動式和服務控制器登入指定下列字串。

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

結構指標，其中包含驗證資訊變更之前所使用的認證。 如果使用者在登入之前強制變更密碼 (或其他驗證資訊) ，則會提供先前的資訊。 如果使用者未強制變更驗證資訊，則此指標為 NULL。 此處預期的值與 lpAuthentInfo 中的值相同。

當 Microsoft 是主要驗證器時，所使用的結構 會MSV1_0_INTERACTIVE_LOGON 或 KERB_INTERACTIVE_LOGON。

[in] lpStationName

字串的指標，指定使用者已登入的月臺名稱。 月臺名稱可用來判斷是否可以取得其他提供者特定資訊。

當 Microsoft 是主要驗證器時，將會指定下列其中一個字串。

值 意義
WinSta_0
 表示這是透過視窗月臺進行互動式登錄。 在此情況下， StationHandle 是父對話框的 HWND 。
SvcCtl
 表示這是由服務控制器起始的登入。 在此案例中，不會使用 StationHandle。

[in] StationHandle

32 位值，其意義取決於名稱 (，因此， lpStationName 中指定的月臺類型) 。

值 意義
WinSta_0
 (hwndOwner) 目前顯示在畫面上的擁有者對話框句柄。
SvcCtl
 隨機數據。 請勿使用。

[in] dwChangeInfo

如果設定，則指定提供變更資訊的旗標。 此參數可以是其中一個旗標。

值 意義
WN_VALID_LOGON_ACCOUNT
 此旗標表示已變更的驗證資訊會影響所有未來的登入。 用戶屬於受信任的網域。
WN_NT_PASSWORD_CHANGED
 此旗標表示密碼已變更。

某些驗證資訊變更只會影響在不受信任的網域中所做的連線。 這些是用戶無法用來登入這部計算機的帳戶。 在這些情況下，不會設定 dwChangeInfo 。

傳回值

如果函式成功，函式會傳回WN_SUCCESS。

如果函式失敗，它會傳回錯誤碼，可以是下列其中一個值。

傳回碼 Description
WN_NOT_SUPPORTED

不支援 NPPasswordChangeNotify。
WN_NO_NETWORK
 網路不存在。
WN_FUNCTION_BUSY
 認證管理員仍在初始化，尚未準備好呼叫。

備註

NPPasswordChangeNotify 函式是由認證管理員實作，以在驗證資訊變更時接收通知。

Windows Server 2003 和 Windows XP： NPPasswordChangeNotify 會在使用者登入的計算機上呼叫，如果密碼已在其他地方變更。 請注意，從 Windows Vista 和 Windows Server 2008 開始，不支援此行為。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 npapi.h

另請參閱

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify