LSA_GET_AUTH_DATA_FOR_USER コールバック関数 (ntsecpkg.h)
GetAuthDataForUser 関数は、セキュリティ アカウント マネージャー (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列挙値。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 意味 |
|---|---|
|
名前 は SAM と互換性があります。 SAM 互換形式の名前の例として、"ExampleDomain\Username" があります。 |
|
名前 は、SAM アカウントの AltSecId プロパティにあります。 この値を使用する場合は、 Prefix パラメーターの値を指定する必要があります。 |
|
名前 は、フラット ユーザー プリンシパル名 (UPN) スタイルのアカウント名です。 |
|
Name は、オブジェクトの識別名です。 詳細については、「解説」を参照してください。 |
[in] Prefix
SecNameAlternateIdNameType で指定された名前に使用するプレフィックスを含むUNICODE_STRING構造体へのポインター。
[out] UserAuthData
取得したデータのアドレスを受け取るポインター。
[out] UserAuthDataSize
取得したデータのサイズを受け取る ULONG へのポインター。
[out] UserFlatName
UPN を受け取る UNICODE_STRING 構造体へのポインター (該当する場合)。
戻り値
関数が成功した場合、戻り値はSTATUS_SUCCESS。
関数が失敗した場合、戻り値は失敗した理由を示す NTSTATUS コードです。
注釈
GetAuthDataForUser 関数は、OpenSamUser、GetUserAuthData、CloseSamUser 関数を 1 つの呼び出しに結合します。
これらの関数へのポインターは、SpInitialize 関数によって受け取られたLSA_SECPKG_FUNCTION_TABLE構造体で使用できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | ntsecpkg.h |