RtlInitializeCorrelationVector function

Initializes the specified correlation vector with the supplied GUID.

Syntax

NTSYSAPI NTSTATUS RtlInitializeCorrelationVector(
  PCORRELATION_VECTOR CorrelationVector,
  int                 Version,
  const GUID          *Guid
);

Parameters

CorrelationVector

A pointer to a CORRELATION_VECTOR structure that represents the correlation vector to be initialized.

Version

The version of the correlation vector. Possible values are:

  • RTL_CORRELATION_VECTOR_VERSION_1
  • RTL_CORRELATION_VECTOR_VERSION_2
  • RTL_CORRELATION_VECTOR_VERSION_CURRENT

Guid

The GUID to initialize the correlation vector. The first 22 bytes of the correlation vector are a base64 representation of the GUID. This value must not be NULL.

Return Value

Returns an NTSTATUS value that indicates the success of failure of the operation.

Return code Description
STATUS_SUCCESS
The correlation vector was successfully initialized.
STATUS_INVALID_PARAMETER
The supplied GUID is null.

Requirements

   
Minimum supported client Windows 10, version 1709
Minimum supported server Windows Server 2016
Target Platform Windows
Header ntddk.h
Library NtosKrnl.lib
DLL NtosKrnl.exe (kernel mode)
IRQL PASSIVE_LEVEL

See Also

CORRELATION_VECTOR