Msv1_0SubAuthenticationRoutineGeneric function (subauth.h)
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 |