Compartilhar via

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

Envia metadados para um provedor de suporte de segurança. Os metadados enviados por essa função são obtidos por uma chamada anterior para a função SpQueryMetaDataFn .

Sintaxe

SpExchangeMetaDataFn Spexchangemetadatafn;

NTSTATUS Spexchangemetadatafn(
  [in]           LSA_SEC_HANDLE CredentialHandle,
  [in, optional] PUNICODE_STRING TargetName,
  [in]           ULONG ContextRequirements,
  [in]           ULONG MetaDataLength,
  [in]           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.

[in] MetaDataLength

O tamanho, em caracteres, do buffer MetaData .

[in] MetaData

Os metadados a serem enviados.

[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 SpExchangeMetaDataFn 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
  • Last updated on