CallPackage
TOC
Collapse the table of content
Expand the table of content

CallPackage function

The CallPackage function is used to call another security package to access its services.

Syntax


NTSTATUS CallPackage(
  _In_  PUNICODE_STRING AuthenticationPackage,
  _In_  PVOID           ProtocolSubmitBuffer,
  _In_  ULONG           SubmitBufferLength,
  _Out_ PVOID           *ProtocolReturnBuffer,
  _Out_ PULONG          ReturnBufferLength,
  _Out_ PNTSTATUS       ProtocolStatus
);

Parameters

AuthenticationPackage [in]

Pointer to a UNICODE_STRING containing the name of the package to call.

ProtocolSubmitBuffer [in]

Pointer to the input buffer. The content of this buffer is package-specific.

SubmitBufferLength [in]

Size of the ProtocolSubmitBuffer parameter in bytes.

ProtocolReturnBuffer [out]

Pointer that receives the address of the output buffer. The content of this buffer is package-specific.

ReturnBufferLength [out]

Pointer to a variable that receives the size of the ProtocolReturnBuffer parameter in bytes.

ProtocolStatus [out]

Pointer to a variable that receives the status code returned by the called package.

Return value

If the function succeeds, the return value is STATUS_SUCCESS.

If the function fails, the return value is an NTSTATUS code indicating the reason it failed. The following table lists a common reason for failure and the error code that the function returns.

Return codeDescription
STATUS_NO_SUCH_PACKAGE

The AuthenticationPackage parameter does not contain the name of a valid security package.

 

Remarks

A pointer to the CallPackage function is available in the LSA_SECPKG_FUNCTION_TABLE structure received by the SpInitialize function.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntsecpkg.h

See also

CallPackageEx
LSA_SECPKG_FUNCTION_TABLE
SpInitialize

 

 

Show:
© 2016 Microsoft