Msv1_0SubAuthenticationRoutineGeneric function

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.


NTSTATUS WINAPI Msv1_0SubAuthenticationRoutineGeneric(
        PVOID  SubmitBuffer,
        ULONG  SubmitBufferLength,
  _Out_ PULONG ReturnBufferLength,
  _Out_ PVOID  *ReturnBuffer



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


The size, in bytes, of the SubmitBuffer buffer.

ReturnBufferLength [out]

The size, in bytes, of the ReturnBuffer buffer.

ReturnBuffer [out]

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.


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]



See also