Share via

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

  • Artigo

A função SpInitUserModeContext cria um contexto de segurança no modo de usuário de um contexto de modo LSA ( Autoridade de Segurança Local ) empacotado.

Sintaxe

SpInitUserModeContextFn Spinitusermodecontextfn;

NTSTATUS Spinitusermodecontextfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] PSecBuffer PackedContext
)
{...}

Parâmetros

[in] ContextHandle

Um identificador para o contexto do modo LSA retornado da função SpInitLsaModeContext ou SpAcceptLsaModeContext .

[in] PackedContext

Ponteiro para uma estrutura SecBuffer que contém os dados de contexto serializados . Use a função FreeContextBuffer para liberar memória alocada para essa estrutura.

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. O exemplo a seguir lista um motivo comum para a falha e o código de erro que a função deve retornar.

Código de retorno Descrição
STATUS_INSUFFICIENT_RESOURCES
 Memória insuficiente para criar o contexto.

Comentários

A função SpInitUserModeContext é chamada depois que um contexto de segurança é criado pelo pacote de segurança, se o parâmetro MappedContext do SpInitLsaModeContext ou SpAcceptLsaModeContext estiver definido como TRUE. Os dados de contexto específicos do pacote devem conter as informações necessárias para determinar qual função resultou na chamada para SpInitUserModeContext.

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

Um ponteiro para a função SpInitUserModeContext está disponível na estrutura SECPKG_USER_FUNCTION_TABLE recebida da função SpUserModeInitialize .

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

SECPKG_USER_FUNCTION_TABLE

SpAcceptLsaModeContext

SpInitLsaModeContext

SpUserModeInitialize