Expand Minimize
This topic has not yet been rated - Rate this topic

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

 

 

Send comments about this topic to Microsoft

Build date: 1/2/2013

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.