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。

傳回值

備註

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

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

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

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

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

規格需求

另請參閱

InitializeChangeNotify

PasswordFilter