Edit

Share via

RtlInitializeCorrelationVector function (ntddk.h)

Initializes the specified correlation vector with the supplied GUID.

Syntax

NTSYSAPI NTSTATUS RtlInitializeCorrelationVector(
  [in, out] PCORRELATION_VECTOR CorrelationVector,
  [in]      int                 Version,
  [in]      const GUID          *Guid
);

Parameters

[in, out] CorrelationVector

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

[in] 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

[in] 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

Requirement Value
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