SeciAllocateAndSetIPAddress function

Article
08/14/2023

Sets the caller's IP address to appear in security audit events.

Syntax

SECURITY_STATUS SEC_ENTRY SeciAllocateAndSetIPAddress(
  _in_  PUCHAR IPAddress,
  _in_  ULONG  IPAddressLength,
  _out_ PBOOL  FreeCallContext
);

Parameters

IPAddress [in]

A pointer to the IP address to be set. The IP address is represented as a SOCKADDR structure.

IPAddressLength [in]

The length of the IPAddress structure.

FreeCallContext [out]

If set to TRUE, the caller is responsible for calling SeciFreeCallContext.

Return value

If the function succeeds, it returns SEC_E_OK.

If the function fails, it returns a non-zero error code.

Remarks

This function is not present in the SDK headers. To use it, call the LoadLibrary function to obtain a handle to SSPICLI.DLL and then use GetProcAddress to obtain the function address.

The IPAddress parameter should be a valid pointer to an IP address structure obtained from the network layer. This corresponds to the addr output parameter to the Accept function.

If FreeCallContext is set to TRUE on output, the caller must call SeciFreeCallContext function before relinquishing the thread.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target platform	Windows
Header	None
Library	None
DLL	SSPICLI.DLL