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列挙値。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
SecNameSamCompatible
 名前 は SAM と互換性があります。 SAM 互換形式の名前の例として、"ExampleDomain\Username" があります。
SecNameAlternateId
 名前 は、SAM アカウントの AltSecId プロパティにあります。 この値を使用する場合は、 Prefix パラメーターの値を指定する必要があります。
SecNameFlat
 名前 は、フラット ユーザー プリンシパル名 (UPN) スタイルのアカウント名です。
SecNameDN
 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

こちらもご覧ください

CloseSamUser

GetUserAuthData

LSA_SECPKG_FUNCTION_TABLE

OpenSamUser

SpInitialize