Função de retorno de chamada PFNDAVAUTHCALLBACK (davclnt.h)
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 |
|---|---|
|
A autenticação básica deve ser usada. |
|
A autenticação NTLM da Microsoft deve ser usada. |
|
A autenticação do Passport deve ser usada. |
|
A autenticação do Microsoft Digest deve ser usada. |
|
A Negociação da Microsoft deve ser usada. |
|
A autenticação de certificado deve ser usada. |
|
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 |