LsaLookupAuthenticationPackage 関数 (ntsecapi.h)

LsaLookupAuthenticationPackage 関数は、認証パッケージの一意識別子を取得します。

構文

NTSTATUS LsaLookupAuthenticationPackage(
  [in]  HANDLE      LsaHandle,
  [in]  PLSA_STRING PackageName,
  [out] PULONG      AuthenticationPackage
);

[in] LsaHandle

LsaRegisterLogonProcess または LsaConnectUntrusted の以前の呼び出しから取得したハンドル。

[in] PackageName

認証パッケージの名前を指定する LSA_STRING 構造体へのポインター。パッケージ名の長さは 127 バイトを超えることはできません。次の表に、Microsoft が提供する認証パッケージの名前を示します。

値	意味
MSV1_0_PACKAGE_NAME	MSV1_0認証パッケージ名の ANSI バージョン。
MICROSOFT_KERBEROS_NAME_A	Kerberos 認証パッケージ名の ANSI バージョン。
NEGOSSP_NAME_A	ネゴシエート認証パッケージ名の ANSI バージョン。

[out] AuthenticationPackage

認証パッケージ識別子を受け取る ULONG へのポインター。

関数が成功した場合、戻り値はSTATUS_SUCCESS。

関数が失敗した場合、戻り値は NTSTATUS コードです。考えられるエラーコードを次に示します。

リターンコード	説明
STATUS_NO_SUCH_PACKAGE	指定された認証パッケージは LSA に対して不明です。
STATUS_NAME_TOO_LONG	認証パッケージ名が 127 バイトを超えています。

詳細については、「 LSA ポリシー関数の戻り値」を参照してください。

LsaNtStatusToWinError 関数は、NTSTATUS コードを Windows エラーコードに変換します。

認証パッケージ識別子は、 LsaLogonUser や LsaCallAuthenticationPackage などの認証関数の呼び出しで使用されます。