Função NPPasswordChangeNotify (npapi.h)

  • Artigo

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.

Valor Significado
WinSta_0
 Indica que se trata de um logon interativo por meio da estação de janela. Nesse caso, StationHandle é um HWND para a caixa de diálogo pai.
SvcCtl
 Indica que esse é um logon iniciado pelo controlador de serviço. StationHandle não é usado nesse caso.

[in] StationHandle

Um valor de 32 bits cujo significado depende do nome (e, consequentemente, do tipo) da estação especificada em lpStationName.

Valor Significado
WinSta_0
 Um identificador para a caixa de diálogo proprietário (hwndOwner) exibido atualmente na tela.
SvcCtl
 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.

Valor Significado
WN_VALID_LOGON_ACCOUNT
 Esse sinalizador indica que as informações de autenticação alteradas afetarão todos os logons futuros. O usuário pertence a um domínio confiável.
WN_NT_PASSWORD_CHANGED
 Esse sinalizador indica que a senha foi alterada.

Algumas alterações de informações de autenticação afetarão apenas as conexões feitas em domínios não confiáveis. Essas são as contas que o usuário não pode usar para fazer logon neste computador de qualquer maneira. Nesses casos, dwChangeInfo não está definido.

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
WN_NOT_SUPPORTED

Não há suporte para NPPasswordChangeNotify.
WN_NO_NETWORK
 A rede não está presente.
WN_FUNCTION_BUSY
 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

Confira também

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify