SpMarshallSupplementalCreds function

The SpMarshallSupplementalCreds function converts supplemental credentials from a public format into a format suitable for local procedure calls.

Syntax


NTSTATUS SpMarshallSupplementalCreds(
  _In_  ULONG  CredentialSize,
  _In_  PUCHAR Credentials,
  _Out_ PULONG MarshalledCredSize,
  _Out_ PVOID  *MarshalledCreds
);

Parameters

CredentialSize [in]

Specifies the size of the supplemental credentials.

Credentials [in]

Pointer to the supplemental credentials.

MarshalledCredSize [out]

Pointer to the size of the MarshalledCreds buffer.

MarshalledCreds [out]

Pointer that receives the address of the buffer containing the serialized credentials. Allocate the memory for this buffer by calling the AllocateHeap function.

Return value

If the function succeeds, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS code that indicates the reason it failed.

Remarks

SSP/APs must implement the SpMarshallSupplementalCreds function; however, the actual name given to the implementation is up to the developer.

A pointer to the SpMarshallSupplementalCreds function is available in the SECPKG_USER_FUNCTION_TABLE structure received from the SpUserModeInitialize function.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntsecpkg.h

See also

AllocateHeap
SECPKG_USER_FUNCTION_TABLE
SpUserModeInitialize

 

 

Show: