RegisterCallback function

Registers user-mode callback functions. The RegisterCallback function is called by a user-mode security package.

A security package loaded into the Local Security Authority (LSA) process can call a registered user-mode callback function using the ClientCallBack function available in the LSA_SECPKG_FUNCTION_TABLE structure.

Syntax

NTSTATUS RegisterCallback(
  _In_ ULONG                  CallbackId,
  _In_ PLSA_CALLBACK_FUNCTION Callback
);

Parameters

  • CallbackId [in]
    Specifies an identifier for the function.

  • Callback [in]
    Specifies the callback function that will execute in the user's process space. For information about the prototype for this function, see ClientCallback Function Prototype.

Return value

If the function succeeds, the return value is STATUS_SUCCESS.

If the function fails, the return value is an NTSTATUS code indicating the reason it failed.

Remarks

The registered function is accessed by means of the ClientCallback function.

A pointer to the RegisterCallback function is available in the SECPKG_DLL_FUNCTIONS structure received from the SpInstanceInit function.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntsecpkg.h

See also

ClientCallback

ClientCallback Function Prototype