共用方式為

PSAM_PASSWORD_NOTIFICATION_ROUTINE回呼函式 (ntsecapi.h)

  • 發行項

PasswordChangeNotify 函式是由密碼篩選 DLL 實作。 它會通知 DLL 密碼已變更。

語法

PSAM_PASSWORD_NOTIFICATION_ROUTINE PsamPasswordNotificationRoutine;

NTSTATUS PsamPasswordNotificationRoutine(
  [in] PUNICODE_STRING UserName,
  [in] ULONG RelativeId,
  [in] PUNICODE_STRING NewPassword
)
{...}

參數

[in] UserName

密碼變更之用戶的帳戶名稱。

如果此參數的值和 NewPassword 參數為 NULL，此函式應該會傳回 STATUS_SUCCESS。

[in] RelativeId

UserName 中所指定使用者的相對標識碼 (RID) 。

[in] NewPassword

UserName 中所指定使用者的新純文本密碼。 當您完成使用密碼時，請呼叫 SecureZeroMemory 函式 來清除資訊。 如需保護密碼的詳細資訊，請參閱 處理密碼。

如果此參數和 UserName 參數的值為 NULL，此函式應該會傳回 STATUS_SUCCESS。

傳回值

傳回碼 Description
STATUS_SUCCESS
 指出使用者的密碼已變更，或 UserName 和 NewPassword 參數的值都是 NULL。

備註

在成功呼叫 PasswordFilter 函式並儲存新的密碼之後，就會呼叫 PasswordChangeNotify 函式。

此函式必須使用__stdcall呼叫慣例，而且必須由 DLL 匯出。

當 PasswordChangeNotify 例程執行時，處理會遭到封鎖，直到例程完成為止。 適當時，請先將任何冗長的處理移至個別線程，再從這個例程傳回。

此函式只會針對系統上安裝和註冊 的密碼篩選 呼叫。

此函式內未處理的任何進程例外狀況，都可能會導致整個系統的安全性相關失敗。 適當時應使用結構化例外狀況處理。

如需下列資訊 請參閱
實作密碼篩選 DLL 的程式設計問題 密碼篩選程式設計考慮
如何安裝和註冊您自己的密碼篩選 DLL 安裝和註冊密碼篩選 DLL
Microsoft 提供的密碼篩選 DLL 強密碼強制和 Passfilt.dll

規格需求

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

另請參閱

InitializeChangeNotify

PasswordFilter