共用方式為


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 函式會將 OpenSamUserGetUserAuthDataCloseSamUser 函式結合成一個呼叫。

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

規格需求

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

另請參閱

CloseSamUser

GetUserAuthData

LSA_SECPKG_FUNCTION_TABLE

OpenSamUser

SpInitialize