共用方式為

Msv1_0SubAuthenticationRoutineEx函式 (subauth.h)

  • 發行項

藉由呼叫 LogonUser 函式來要求子驗證時，執行遠端訪問服務驗證。

安全性主體的認證和資訊安全帳戶管理員 (SAM) 資料庫的資訊會傳遞至此函式以進行驗證。

此函式是由自定義子驗證套件 DLL 實作，以便與MSV1_0驗證套件搭配使用。

此函式只會針對 非互動式驗證呼叫，只在帳戶所在的驗證伺服器上，而且只有在登錄中的正確密鑰下註冊子驗證 DLL 時才呼叫。

語法

NTSTATUS Msv1_0SubAuthenticationRoutineEx(
  [in]      NETLOGON_LOGON_INFO_CLASS LogonLevel,
  [in]      PVOID                     LogonInformation,
  [in]      ULONG                     Flags,
  [in]      PUSER_ALL_INFORMATION     UserAll,
  [in]      SAM_HANDLE                UserHandle,
  [in, out] PMSV1_0_VALIDATION_INFO   ValidationInfo,
  [out]     PULONG                    ActionsPerformed
);

參數

[in] LogonLevel

指定 LogonInformation 參數中所提供的資訊層級。 此參數通常設定為 NetlogonInteractiveInformation。

[in] LogonInformation

NETLOGON_LOGON_IDENTITY_INFO 結構的指標。 此結構的成員包含登入之使用者的相關信息。 忽略這個結構的 LogonDomainName 成員。

[in] Flags

選擇性。 包含描述登入情況的旗標。 此參數可以是下列其中一個值。

值 意義
MSV1_0_PASSTHRU
 傳遞驗證。 使用者未連線到這部電腦。
MSV1_0_GUEST_LOGON
 這是使用 GUEST 使用者帳戶重試登入。

[in] UserAll

USER_ALL_INFORMATION 結構的指標，其中包含從 SAM 資料庫傳回的使用者描述。

[in] UserHandle

用戶帳戶的句柄。

[in, out] ValidationInfo

MSV1_0_VALIDATION_INFO 結構的指標。

[out] ActionsPerformed

執行的動作清單。

傳回值

此函式必須傳回下列其中一個值。

傳回碼 Description
STATUS_SUCCESS
 沒有錯誤。
STATUS_ACCOUNT_DISABLED
 帳戶已停用。
STATUS_ACCOUNT_EXPIRED
 帳戶已過期。
STATUS_ACCOUNT_LOCKED_OUT
 帳戶已經鎖定。
STATUS_INVALID_INFO_CLASS
 LogonLevel 無效。
STATUS_INVALID_WORKSTATION
 使用者未獲授權登入指定的工作站。
STATUS_NO_SUCH_USER
 指定的用戶沒有帳戶。
STATUS_PASSWORD_EXPIRED
 密碼已過期。
STATUS_PASSWORD_MUST_CHANGE
 帳戶標示為表示下次登入時必須變更密碼。
STATUS_WRONG_PASSWORD
 密碼無效。

規格需求

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