Função de retorno de chamada PFNDAVAUTHCALLBACK (davclnt.h)

Artigo
08/23/2023

O cliente WebDAV chama a função de retorno de chamada DavAuthCallback definida pelo aplicativo para solicitar credenciais ao usuário.

O tipo PFNDAVAUTHCALLBACK define um ponteiro para essa função de retorno de chamada. DavAuthCallback é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PFNDAVAUTHCALLBACK Pfndavauthcallback;

DWORD Pfndavauthcallback(
  [in]      LPWSTR lpwzServerName,
  [in]      LPWSTR lpwzRemoteName,
  [in]      DWORD dwAuthScheme,
  [in]      DWORD dwFlags,
  [in, out] PDAV_CALLBACK_CRED pCallbackCred,
  [in, out] AUTHNEXTSTEP *NextStep,
  [out]     PFNDAVAUTHCALLBACK_FREECRED *pFreeCred
)
{...}

Parâmetros

[in] lpwzServerName

Um ponteiro para uma cadeia de caracteres Unicode terminada em NULL que contém o nome do servidor de destino.

[in] lpwzRemoteName

Um ponteiro para uma cadeia de caracteres Unicode terminada em NULL que contém o nome do recurso de rede.

[in] dwAuthScheme

Uma máscara de bits de sinalizadores que especifica os esquemas de autenticação a serem usados.

Valor	Significado
DAV_AUTHN_SCHEME_BASIC 0x00000001	A autenticação básica deve ser usada.
DAV_AUTHN_SCHEME_NTLM 0x00000002	A autenticação NTLM da Microsoft deve ser usada.
DAV_AUTHN_SCHEME_PASSPORT 0x00000004	A autenticação do Passport deve ser usada.
DAV_AUTHN_SCHEME_DIGEST 0x00000008	A autenticação do Microsoft Digest deve ser usada.
DAV_AUTHN_SCHEME_NEGOTIATE 0x00000010	A Negociação da Microsoft deve ser usada.
DAV_AUTHN_SCHEME_CERT 0x00010000	A autenticação de certificado deve ser usada.
DAV_AUTHN_SCHEME_FBA 0x00100000	A autenticação baseada em formulários deve ser usada.

[in] dwFlags

Os sinalizadores que o serviço WebDAV passou no parâmetro dwFlags quando chamou a função NPAddConnection3 .

[in, out] pCallbackCred

Um ponteiro para uma estrutura DAV_CALLBACK_CRED .

[in, out] NextStep

Um ponteiro para um valor de enumeração AUTHNEXTSTEP que especifica a próxima ação que o cliente WebDAV deve tomar após uma chamada bem-sucedida para a função de retorno de chamada DavAuthCallback .

[out] pFreeCred

Um ponteiro para uma função de retorno de chamada DavFreeCredCallback .

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema.

Comentários

A função de retorno de chamada DavAuthCallback deve ser registrada chamando a função DavRegisterAuthCallback .

Para cancelar o registro dessa função de retorno de chamada, use a função DavUnregisterAuthCallback .

Essa função de retorno de chamada deve solicitar ao usuário credenciais (um nome de usuário e uma senha ou um BLOB de autenticação) e armazenar essas informações no membro apropriado da estrutura de DAV_CALLBACK_CRED para a qual o parâmetro pCallbackCred aponta.

Requisitos


Cliente mínimo com suporte	Windows Vista com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 com SP2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	davclnt.h