Edit

Share via

SspiDecryptAuthIdentityEx function (sspi.h)

  • Article

Decrypts a SEC_WINNT_AUTH_IDENTITY_OPAQUE structure.

Syntax

SECURITY_STATUS SEC_ENTRY SspiDecryptAuthIdentityEx(
  [in]      ULONG                           Options,
  [in, out] PSEC_WINNT_AUTH_IDENTITY_OPAQUE EncryptedAuthData
);

Parameters

[in] Options

Decryption options. This parameter should be the same value as the value passed to the SspiEncryptAuthIdentityEx function, which can be one of the following values.

Value Meaning
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON
 The encrypted structure can only be decrypted by a security context in the same logon session. This option is used to protect an identity buffer that is being sent over a local RPC.
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_PROCESS
 The encrypted structure can only be decrypted by the same process. Calling the function with this option is equivalent to calling SspiEncryptAuthIdentity. This option is used to protect an identity buffer that is being persisted in a process's private memory for an extended period.

[in, out] EncryptedAuthData

This buffer is the output of the SspiEncryptAuthIdentityEx function.

Return value

If the function succeeds, it returns SEC_E_OK.

If the function fails, it returns a nonzero error code.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header sspi.h