ClientCallback function

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


NTSTATUS ClientCallback(
  _In_  PCHAR      Callback,
  _In_  ULONG_PTR  Argument1,
  _In_  ULONG_PTR  Argument2,
  _In_  PSecBuffer Input,
  _Out_ PSecBuffer Output
);

Parameters

Callback [in]

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

Argument1 [in]

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

Argument2 [in]

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

Input [in]

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

Output [out]

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntsecpkg.h

See also

ClientCallback_Function
LSA_SECPKG_FUNCTION_TABLE
RegisterCallback
SpInitialize

 

 

Show: