LSA_CLIENT_CALLBACK callback function (ntsecpkg.h)

Article
02/22/2024

The ClientCallback function allows a Local Security Authority (LSA)-mode security package to call back to its user-mode package and invoke a function in its DLL there.

Syntax

LSA_CLIENT_CALLBACK LsaClientCallback;

NTSTATUS LsaClientCallback(
  [in]  PCHAR Callback,
  [in]  ULONG_PTR Argument1,
  [in]  ULONG_PTR Argument2,
  [in]  PSecBuffer Input,
  [out] PSecBuffer Output
)
{...}

Parameters

[in] Callback

A pointer to the name of the function to invoke. For more information, see ClientCallback_Function.

[in] Argument1

A pointer to the first argument to pass to the callback function.

[in] Argument2

A pointer to the second argument to pass to the callback function.

[in] Input

A pointer to a SecBuffer structure that contains information to pass to the callback function.

[out] Output

A pointer to a SecBuffer structure that receives information passed from the callback function.

Return value

If the function succeeds, the function returns STATUS_SUCCESS.

If the function fails, it returns an NTSTATUS code that indicates the reason it failed.

Remarks

A pointer to the ClientCallback function is available in the LSA_SECPKG_FUNCTION_TABLE structure received by the SpInitialize function.

The user-mode security package must use the RegisterCallback function to register the function to be called.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	ntsecpkg.h

Share via