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

  • Artigo

Obtém metadados de um provedor de suporte de segurança (SSP) ao iniciar um contexto de segurança.

Sintaxe

SpQueryMetaDataFn Spquerymetadatafn;

NTSTATUS Spquerymetadatafn(
  [in]           LSA_SEC_HANDLE CredentialHandle,
  [in, optional] PUNICODE_STRING TargetName,
  [in]           ULONG ContextRequirements,
  [out]          PULONG MetaDataLength,
  [out]          PUCHAR *MetaData,
  [in, out]      PLSA_SEC_HANDLE ContextHandle
)
{...}

Parâmetros

[in] CredentialHandle

Um identificador para as credenciais a serem usadas para o contexto de segurança. Se o parâmetro ContextHandle apontar para NULL na entrada, essa função usará o valor desse parâmetro para criar um contexto de segurança.

O valor desse parâmetro não poderá ser NULL se o parâmetro ContextHandle apontar para NULL na entrada.

[in, optional] TargetName

Um ponteiro para um UNICODE_STRING que contém o nome do destino do contexto.

[in] ContextRequirements

Sinalizadores que indicam os atributos de contexto exigidos pelo cliente.

Os seguintes valores são válidos: Os valores podem ser combinados usando uma operação OR lógica.

Valor Significado
ISC_REQ_DELEGATE
 O servidor tem permissão para representar o cliente.
ISC_REQ_MUTUAL_AUTH
 O cliente e o servidor são necessários para provar sua identidade.
ISC_REQ_REPLAY_DETECT
 O contexto de segurança dará suporte à detecção de pacotes reproduzidos.
ISC_REQ_SEQUENCE_DETECT
 O contexto de segurança dará suporte à detecção de mensagens fora de ordem.
ISC_REQ_USE_SESSION_KEY
 Uma nova chave de sessão deve ser negociada.
ISC_REQ_PROMPT_FOR_CREDS
 Se o cliente for um usuário interativo, o pacote deverá, se possível, solicitar ao usuário as credenciais apropriadas.
ISC_REQ_USE_SUPPLIED_CREDS
 O buffer de entrada contém informações de credencial específicas do pacote que devem ser usadas para autenticar a conexão.
ISC_REQ_ALLOCATE_MEMORY
 O pacote deve alocar memória. O chamador deve eventualmente chamar a função FreeContextBuffer para liberar a memória alocada pelo pacote.
ISC_REQ_USE_DCE_STYLE
 O chamador espera uma transação de autenticação mútua de três etapas.
ISC_REQ_DATAGRAM
 Um canal de comunicação do tipo datagram deve ser usado. Para obter mais informações, consulte Contextos de datagrama.
ISC_REQ_CONNECTION
 Um canal de comunicação do tipo conexão deve ser usado. Para obter mais informações, consulte Contextos orientados para conexão.
ISC_REQ_EXTENDED_ERROR
 Se o contexto falhar, gere uma mensagem de resposta de erro para enviar de volta ao cliente.
ISC_REQ_STREAM
 Um canal de comunicação do tipo fluxo deve ser usado. Para obter mais informações, consulte Contextos de Stream.
ISC_REQ_INTEGRITY
 A integridade do buffer é verificada; no entanto, mensagens reproduzidas e fora de sequência não serão detectadas.

[out] MetaDataLength

O tamanho, em caracteres, do buffer MetaData .

[out] MetaData

Os metadados que o SSP fornece.

[in, out] ContextHandle

Um identificador para o identificador de segurança a ser usado. Se esse parâmetro apontar para NULL na entrada, essa função alocará e inicializará um contexto de segurança usando os valores dos parâmetros CredentialHandle e TargetName .

Se esse parâmetro apontar para NULL na entrada, credentialHandle não poderá ser NULL.

Retornar valor

Se a função for bem-sucedida, retorne STATUS_SUCCESS ou um código de status informativo.

Se a função falhar, retorne um código de erro NTSTATUS que indica o motivo pelo qual ela falhou. Para obter mais informações, consulte Comentários.

Comentários

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

Requisitos

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