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

A função SpQueryContextAttributes recupera os atributos de um contexto de segurança.

A função SpQueryContextAttributes é a função de expedição para a função QueryContextAttributes (Geral) da Interface do Provedor de Suporte de Segurança.

Sintaxe

SpQueryContextAttributesFn Spquerycontextattributesfn;

NTSTATUS Spquerycontextattributesfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  ULONG ContextAttribute,
  [out] PVOID Buffer
)
{...}

Parâmetros

[in] ContextHandle

Um identificador para o contexto de segurança.

[in] ContextAttribute

Atributo de contexto para consulta. Para obter uma lista de valores válidos, consulte a função QueryContextAttributes (Geral).

[out] Buffer

Ponteiro que recebe o endereço de um buffer que contém os atributos solicitados. A memória do parâmetro Buffer deve ser alocada com a função AllocateHeap da tabela de funções SECPKG_DLL_FUNCTIONS no modo de usuário. No modo LSA ( Autoridade de Segurança Local ), use a função AllocateLsaHeap .

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

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

Comentários

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

Um ponteiro para a implementação do modo LSA da função SpQueryContextAttributes está disponível na estrutura SECPKG_FUNCTION_TABLE recebida da função SpLsaModeInitialize .

Um ponteiro para a implementação do modo de usuário da função SpQueryContextAttributes 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_FUNCTION_TABLE

SpLsaModeInitialize