Função de retorno de chamada SpGetUserInfoFn (ntsecpkg.h)

  • Artigo

A função SpGetUserInfo recupera informações sobre uma sessão de logon.

Sintaxe

SpGetUserInfoFn Spgetuserinfofn;

NTSTATUS Spgetuserinfofn(
  [in]  PLUID LogonId,
  [in]  ULONG Flags,
  [out] PSecurityUserData *UserData
)
{...}

Parâmetros

[in] LogonId

Ponteiro para um LUID que contém a sessão de logon para a qual as informações devem ser recuperadas.

[in] Flags

Especifica o comprimento aceitável do nome de domínio como um dos valores a seguir.

Valor Significado
NO_LONG_NAMES
 O nome de domínio retornado não pode ter mais de 15 caracteres.
UNDERSTANDS_LONG_NAMES
 O nome de domínio retornado pode ter mais de 15 caracteres.

[out] UserData

Ponteiro para um ponteiro para uma estrutura SecurityUserData . Se a chamada de função for bem-sucedida, as informações do usuário serão retornadas nessa estrutura. O pacote de segurança deve alocar a memória para essa estrutura no espaço de endereço do chamador. O chamador é responsável por liberar o buffer chamando a função FreeContextBuffer .

Retornar valor

Se a função for bem-sucedida, retorne STATUS_SUCCESS.

Se a função falhar, retorne um código NTSTATUS que indica o motivo pelo qual ela falhou.

Comentários

O valor Flags NO_LONG_NAMES fornece compatibilidade com o Microsoft NTLM.

SSP/APs devem implementar a função SpGetUserInfo ; no entanto, o nome real fornecido para a implementação cabe ao desenvolvedor.

Um ponteiro para a função SpGetUserInfo está disponível na estrutura SECPKG_FUNCTION_TABLE recebida da função SpLsaModeInitialize .

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

Freecontextbuffer

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize