LSA_OPEN_SAM_USER función de devolución de llamada (ntsecpkg.h)

  • Artículo

Recupera un identificador de una cuenta de usuario en la base de datos administrador de cuentas de seguridad (SAM).

Sintaxis

LSA_OPEN_SAM_USER LsaOpenSamUser;

NTSTATUS LsaOpenSamUser(
  [in]  PSECURITY_STRING Name,
  [in]  SECPKG_NAME_TYPE NameType,
  [in]  PSECURITY_STRING Prefix,
  [in]  BOOLEAN AllowGuest,
  [in]  ULONG Reserved,
  [out] PVOID *UserHandle
)
{...}

Parámetros

[in] Name

Puntero a una estructura de UNICODE_STRING que especifica el nombre de la cuenta SAM.

[in] NameType

Valor de enumeración SECPKG_NAME_TYPE que especifica el tipo de nombre de cuenta en Nombre. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
SecNameSamCompatible
 El nombre es compatible con sam. Un ejemplo de un nombre en formato compatible con SAM es "ExampleDomain\Username".
SecNameAlternateId
 Name se encuentra en la propiedad AltSecId de la cuenta SAM. Este valor se usa con el parámetro Prefix .
SecNameFlat
 El nombre es un nombre principal de usuario plano (UPN): nombre de cuenta de estilo.
SecNameDN
 Name es el nombre distintivo del objeto. Para obtener más información, vea la sección Comentarios.

[in] Prefix

Puntero a una estructura de UNICODE_STRING que especifica el prefijo que se va a usar con nombres que usan un NameType de SecNameAlternateId.

[in] AllowGuest

Especifica si se debe usar la cuenta de invitado si no se encuentra la cuenta SAM. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
FALSE
 Si no se encuentra el usuario, se produce un error en la llamada a la función OpenSamUser .
TRUE
 Si no se encuentra el usuario y la cuenta de invitado está habilitada, se usa la cuenta de invitado.

[in] Reserved

Reservado. Especifique cero.

[out] UserHandle

Puntero a un puntero que recibe un identificador de la cuenta de usuario.

Valor devuelto

Si la función se realiza correctamente, se STATUS_SUCCESS el valor devuelto.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error NTSTATUS que indica el motivo del error.

Código devuelto Descripción
STATUS_INVALID_PARAMETER
 NameType es SecNameAlternateId y Prefix es NULL.
STATUS_NO_SUCH_USER
 No se encontró la cuenta SAM.

Comentarios

Para cerrar el identificador recibido por el parámetro UserHandle , llame a la función CloseSamUser .

El nombre distintivo de un usuario identifica el nombre, el dominio y la ruta de acceso completa al objeto de Active Directory que representa al usuario.

Hay disponible un puntero a la función OpenSamUser en la estructura LSA_SECPKG_FUNCTION_TABLE recibida por la función SpInitialize .

Requisitos

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

Consulte también

CloseSamUser

LSA_SECPKG_FUNCTION_TABLE

SpInitialize