estructura SECPKG_PRIMARY_CRED (ntsecpkg.h)

  • Artículo

La estructura SECPKG_PRIMARY_CRED contiene las credenciales principales. Esta estructura la usan las funciones LsaApLogonUserEx2 y SpAcceptCredentials .

Sintaxis

typedef struct _SECPKG_PRIMARY_CRED {
  LUID           LogonId;
  UNICODE_STRING DownlevelName;
  UNICODE_STRING DomainName;
  UNICODE_STRING Password;
  UNICODE_STRING OldPassword;
  PSID           UserSid;
  ULONG          Flags;
  UNICODE_STRING DnsDomainName;
  UNICODE_STRING Upn;
  UNICODE_STRING LogonServer;
  UNICODE_STRING Spare1;
  UNICODE_STRING Spare2;
  UNICODE_STRING Spare3;
  UNICODE_STRING Spare4;
} SECPKG_PRIMARY_CRED, *PSECPKG_PRIMARY_CRED;

Miembros

LogonId

Identificador de inicio de sesión.

DownlevelName

Estructura UNICODE_STRING que contiene el nombre de la cuenta del Administrador de cuentas de seguridad.

DomainName

Estructura UNICODE_STRING que contiene el nombre de dominio NetBIOS donde se encuentra la cuenta.

Password

Estructura UNICODE_STRING que contiene la contraseña de inicio de sesión. Cuando haya terminado de usar la contraseña, quite la información confidencial de la memoria mediante una llamada a SecureZeroMemory. Para obtener más información sobre cómo proteger la contraseña, consulte Control de contraseñas.

OldPassword

Estructura UNICODE_STRING que contiene la contraseña antigua. Cuando haya terminado de usar la contraseña antigua, quite la información confidencial de la memoria mediante una llamada a SecureZeroMemory.

UserSid

Puntero al identificador de seguridad.

Flags

Conjunto de marcas de credenciales principales . En la tabla siguiente se enumeran los valores válidos para el miembro Flags .

Valor Significado
PRIMARY_CRED_CLEAR_PASSWORD
 Las contraseñas están en texto no cifrado.
PRIMARY_CRED_OWF_PASSWORD
 Las contraseñas se cifran mediante una función unidireccional.
PRIMARY_CRED_UPDATE
 Se trata de un cambio de las credenciales existentes.
PRIMARY_CRED_CACHED_LOGON
 Las credenciales se obtuvieron de un inicio de sesión almacenado en caché. Para obtener más información, vea la sección Comentarios.

DnsDomainName

Estructura UNICODE_STRING que contiene el nombre de dominio DNS donde se encuentra la cuenta de usuario, si se conoce.

Upn

Estructura UNICODE_STRING que contiene el nombre principal de usuario (UPN), si se conoce.

LogonServer

Estructura UNICODE_STRING que contiene el nombre del servidor que procesó el inicio de sesión.

Spare1

Estructura UNICODE_STRING . Reservado.

Spare2

Estructura UNICODE_STRING . Reservado.

Spare3

Estructura UNICODE_STRING . Reservado.

Spare4

Estructura UNICODE_STRING . Reservado.

Comentarios

En el caso de los inicios de sesión almacenados en caché, el identificador RPC del paquete que realiza el inicio de sesión se identifica cambiando el miembro Flags a la derecha mediante la PRIMARY_CRED_LOGON_PACKAGE_SHIFT constante definida a continuación.

#define PRIMARY_CRED_LOGON_PACKAGE_SHIFT 24

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado ntsecpkg.h