LSA_OPEN_SAM_USER função de retorno de chamada (ntsecpkg.h)

  • Artigo

Recupera um identificador para uma conta de usuário no banco de dados sam ( Gerenciador de Contas de Segurança ).

Sintaxe

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

Ponteiro para uma estrutura UNICODE_STRING que especifica o nome da conta SAM.

[in] NameType

Um SECPKG_NAME_TYPE valor de enumeração que especifica o tipo de nome da conta em Nome. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
SecNameSamCompatible
 O nome é compatível com o SAM. Um exemplo de um nome no formato compatível com SAM é "ExampleDomain\Username".
SecNameAlternateId
 Name está na propriedade AltSecId da conta SAM. Esse valor é usado com o parâmetro Prefix .
SecNameFlat
 Nome é um nome upn (nome upn)– estilo de conta de usuário simples.
SecNameDN
 Name é o nome diferenciado do objeto. Para obter mais informações, consulte Comentários.

[in] Prefix

Ponteiro para uma estrutura UNICODE_STRING que especifica o prefixo a ser usado com nomes que usam um NameType de SecNameAlternateId.

[in] AllowGuest

Especifica se a conta convidado deve ser usada se a conta SAM não for encontrada. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
FALSE
 Se o usuário não for encontrado, a chamada de função OpenSamUser falhará.
TRUE
 Se o usuário não for encontrado e a conta convidado estiver habilitada, a conta convidado será usada.

[in] Reserved

Reservado. Especifique zero.

[out] UserHandle

Ponteiro para um ponteiro que recebe um identificador para a conta de usuário.

Retornar valor

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro NTSTATUS que indica o motivo da falha.

Código de retorno Descrição
STATUS_INVALID_PARAMETER
 NameType é SecNameAlternateId e Prefix éNULL.
STATUS_NO_SUCH_USER
 Não foi possível encontrar a conta SAM.

Comentários

Para fechar o identificador recebido pelo parâmetro UserHandle , chame a função CloseSamUser .

O nome diferenciado de um usuário identifica o nome, o domínio e o caminho completo para o objeto do Active Directory que representa o usuário.

Um ponteiro para a função OpenSamUser está disponível na estrutura LSA_SECPKG_FUNCTION_TABLE recebida pela função SpInitialize .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecpkg.h

Confira também

CloseSamUser

LSA_SECPKG_FUNCTION_TABLE

SpInitialize