Edit

Msv1_0SubAuthenticationRoutineGeneric function (subauth.h)

  • Article

Performs Remote Access Service authentication when subauthentication is requested by calling the LsaCallAuthenticationPackage function.

The security principal's credentials and information from the Security Accounts Manager (SAM) database are passed to this function for authentication.

This function is implemented by custom subauthentication package DLLs for use with the MSV1_0 authentication package.

This function is called only for a noninteractive authentication, only on the authenticating server where the account resides, and only if a subauthentication DLL is registered under the correct key in the registry.

Syntax

NTSTATUS Msv1_0SubAuthenticationRoutineGeneric(
        PVOID  SubmitBuffer,
        ULONG  SubmitBufferLength,
  [out] PULONG ReturnBufferLength,
  [out] PVOID  *ReturnBuffer
);

Parameters

SubmitBuffer

A pointer to a buffer that contains a MSV1_0_SUBAUTH_REQUEST structure that contains the authentication information to be submitted.

SubmitBufferLength

The size, in bytes, of the SubmitBuffer buffer.

[out] ReturnBufferLength

The size, in bytes, of the ReturnBuffer buffer.

[out] ReturnBuffer

A pointer to a buffer that contains a MSV1_0_SUBAUTH_RESPONSE structure that contains the response from the subauthentication package.

Return value

If the function succeeds, the return value is STATUS_SUCCESS.

If the function fails, the return value is an NTSTATUS code.

Requirements

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

See also

Msv1_0SubAuthenticationRoutine