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

  • Artigo

Aplica um token de controle a um contexto de segurança. Essa função não é chamada atualmente pela LSA (Autoridade de Segurança Local ).

Sintaxe

SpApplyControlTokenFn Spapplycontroltokenfn;

NTSTATUS Spapplycontroltokenfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] PSecBufferDesc ControlToken
)
{...}

Parâmetros

[in] ContextHandle

Um identificador para o contexto de segurança a ser modificado com base no parâmetro ControlToken .

[in] ControlToken

Ponteiro para uma estrutura SecBufferDesc que contém o token a ser aplicado ao contexto.

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. A seguir, lista os motivos comuns de falha e os códigos de erro que a função deve retornar.

Código de retorno Descrição
SEC_E_INVALID_TOKEN
 O token não é válido.
SEC_E_INVALID_HANDLE
 O identificador não é válido.

Comentários

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

Um ponteiro para a função SpApplyControlToken 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

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize