Expand Minimize

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.

Syntax


NTSTATUS WINAPI 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.

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.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Subauth.h

See also

Msv1_0SubAuthenticationRoutine

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.