LSA_GET_AUTH_DATA_FOR_USER回呼函式 (ntsecpkg.h)

  • 發行項

GetAuthDataForUser 函式會從 Security Accounts Manager (SAM) 資料庫擷取使用者的驗證資訊，並將其放入適合 ConvertAuthDataToToken 函式的格式。

語法

LSA_GET_AUTH_DATA_FOR_USER LsaGetAuthDataForUser;

NTSTATUS LsaGetAuthDataForUser(
  [in]  PSECURITY_STRING Name,
  [in]  SECPKG_NAME_TYPE NameType,
  [in]  PSECURITY_STRING Prefix,
  [out] PUCHAR *UserAuthData,
  [out] PULONG UserAuthDataSize,
  [out] PUNICODE_STRING UserFlatName
)
{...}

參數

[in] Name

指定 SAM 帳戶名稱 之UNICODE_STRING 結構的指標。

[in] NameType

SECPKG_NAME_TYPE列舉值，指定 Name 中的帳戶名稱類型。 此參數可以是下列其中一個值。

值 意義
SecNameSamCompatible
 名稱 與 SAM 相容。 SAM 相容格式的名稱範例為 「ExampleDomain\Username」。。
SecNameAlternateId
 Name 位於 SAM 帳戶的 AltSecId 屬性中。 使用此值時，您必須指定 Prefix 參數的值。
SecNameFlat
 Name 是一般 用戶主體名稱 ， (UPN) 樣式帳戶名稱。
SecNameDN
 Name 是對象的辨別名稱。 如需詳細資訊，請參閱＜備註＞。

[in] Prefix

UNICODE_STRING 結構的指標，其中包含要用於以 SecNameAlternateIdNameType 指定之名稱的前置詞。

[out] UserAuthData

接收所擷取數據的位址的指標。

[out] UserAuthDataSize

接收所擷取數據大小的 ULONG 指標。

[out] UserFlatName

如果適用，則為接收UPN 之UNICODE_STRING 結構的指標。

傳回值

如果函式成功，傳回值會STATUS_SUCCESS。

如果函式失敗，則傳回值是NTSTATUS程式代碼，表示失敗的原因。

備註

GetAuthDataForUser 函式會將 OpenSamUser、GetUserAuthData 和 CloseSamUser 函式結合成一個呼叫。

這些函式的指標可在 SpInitialize 函式收到的LSA_SECPKG_FUNCTION_TABLE結構中使用。

規格需求

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

另請參閱

CloseSamUser

GetUserAuthData

LSA_SECPKG_FUNCTION_TABLE

OpenSamUser

SpInitialize