Função NPPasswordChangeNotify (npapi.h)
Observação
Essa API foi preterida e será removida em uma versão futura.
O MPR chama essa função para notificar o gerenciador de credenciais de um evento de alteração de senha. A função NPPasswordChangeNotify é implementada por uma DLL do gerenciador de credenciais.
Sintaxe
DWORD NPPasswordChangeNotify(
[in] LPCWSTR lpAuthentInfoType,
[in] LPVOID lpAuthentInfo,
[in] LPCWSTR lpPreviousAuthentInfoType,
[in] LPVOID lpPreviousAuthentInfo,
[in] LPWSTR lpStationName,
[in] LPVOID StationHandle,
[in] DWORD dwChangeInfo
);
Parâmetros
[in] lpAuthentInfoType
Ponteiro para uma cadeia de caracteres que identifica o tipo de estrutura apontada por lpAuthentInfo.
Quando a Microsoft é o autenticador primário, a cadeia de caracteres a seguir é especificada para logons interativos e do controlador de serviço.
MSV1_0:Interactive
Kerberos:Interactive
[in] lpAuthentInfo
Ponteiro para uma estrutura que contém as novas credenciais.
Quando a Microsoft é o autenticador primário (ou seja, quando lpAuthentifoType é "MSV1_0:Interactive" ou "Kerberos:Interactive"), a estrutura usada é MSV1_0_INTERACTIVE_LOGON ou KERB_INTERACTIVE_LOGON.
[in] lpPreviousAuthentInfoType
Ponteiro para uma cadeia de caracteres que identifica o tipo de estrutura apontado por lpPreviousAuthentInfo. Se o ponteiro for NULL, não haverá informações anteriores. Os valores esperados aqui são os mesmos do lpAuthentInfoType.
Quando a Microsoft é o autenticador primário, a cadeia de caracteres a seguir é especificada para logons interativos e do controlador de serviço.
MSV1_0:Interactive
[in] lpPreviousAuthentInfo
Ponteiro para uma estrutura que contém as credenciais usadas antes da alteração das informações de autenticação. Informações anteriores são fornecidas se o usuário foi forçado a alterar a senha (ou outras informações de autenticação) antes de fazer logon. Se o usuário não tiver sido forçado a alterar as informações de autenticação, esse ponteiro será NULL. Os valores esperados aqui são os mesmos do lpAuthentInfo.
Quando a Microsoft é o autenticador primário, a estrutura usada é MSV1_0_INTERACTIVE_LOGON ou KERB_INTERACTIVE_LOGON.
[in] lpStationName
Ponteiro para uma cadeia de caracteres que especifica o nome da estação na qual o usuário fez logon. O nome da estação pode ser usado para determinar se informações adicionais específicas do provedor podem ser obtidas.
Quando a Microsoft for o autenticador primário, uma das cadeias de caracteres a seguir será especificada.
[in] StationHandle
Um valor de 32 bits cujo significado depende do nome (e, consequentemente, do tipo) da estação especificada em lpStationName.
Valor | Significado |
---|---|
|
Um identificador para a caixa de diálogo proprietário (hwndOwner) exibido atualmente na tela. |
|
Dados aleatórios. Não use. |
[in] dwChangeInfo
Se definido, especifica um sinalizador que fornece informações de alteração. Esse parâmetro pode ser um dos sinalizadores.
Retornar valor
Se a função for bem-sucedida, a função retornará WN_SUCCESS.
Se a função falhar, ela retornará um código de erro, que pode ser um dos valores a seguir.
Código de retorno | Descrição |
---|---|
|
Não há suporte para NPPasswordChangeNotify. |
|
A rede não está presente. |
|
O gerenciador de credenciais ainda está inicializando e não está pronto para ser chamado. |
Comentários
A função NPPasswordChangeNotify é implementada pelos gerentes de credenciais para receber notificações quando as informações de autenticação são alteradas.
Windows Server 2003 e Windows XP: NPPasswordChangeNotify é chamado em um computador em que um usuário está fazendo logon se a senha tiver sido alterada em outro lugar. Observe que não há suporte para esse comportamento a partir do Windows Vista e do Windows Server 2008.
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 | npapi.h |