NPPasswordChangeNotify 関数 (npapi.h)

  • [アーティクル]

注意

この API は非推奨となり、今後のリリースで削除される予定です。

MPR は、この関数を呼び出して、パスワード変更イベントを資格情報マネージャーに通知します。 NPPasswordChangeNotify 関数は、資格情報マネージャー DLL によって実装されます。

構文

DWORD NPPasswordChangeNotify(
  [in] LPCWSTR lpAuthentInfoType,
  [in] LPVOID  lpAuthentInfo,
  [in] LPCWSTR lpPreviousAuthentInfoType,
  [in] LPVOID  lpPreviousAuthentInfo,
  [in] LPWSTR  lpStationName,
  [in] LPVOID  StationHandle,
  [in] DWORD   dwChangeInfo
);

パラメーター

[in] lpAuthentInfoType

lpAuthentInfo によって指される構造体の種類を識別する文字列へのポインター。

Microsoft がプライマリ認証システムの場合、対話型およびサービス コントローラーのログオンに対して次の文字列が指定されます。

MSV1_0:Interactive 
Kerberos:Interactive

[in] lpAuthentInfo

新しい資格情報を含む構造体へのポインター。

Microsoft がプライマリ認証システムである場合 (つまり、 lpAuthentifoType が "MSV1_0:Interactive" または "Kerberos:Interactive" の場合)、使用される構造体は MSV1_0_INTERACTIVE_LOGON または KERB_INTERACTIVE_LOGON。

[in] lpPreviousAuthentInfoType

lpPreviousAuthentInfo によって指される構造体の種類を識別する文字列へのポインター。 ポインターが NULL の場合、以前の情報はありませんでした。 ここで想定される値は、 lpAuthentInfoType の値と同じです。

Microsoft がプライマリ認証システムの場合、対話型およびサービス コントローラーのログオンに対して次の文字列が指定されます。

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

認証情報が変更される前に使用される資格情報を含む構造体へのポインター。 ログオン前にユーザーがパスワード (またはその他の認証情報) の変更を強制された場合は、事前の情報が提供されます。 ユーザーが認証情報の変更を強制されなかった場合、このポインターは NULL です。 ここで想定される値は、 lpAuthentInfo の値と同じです。

Microsoft がプライマリ認証システムの場合、使用される構造体は MSV1_0_INTERACTIVE_LOGON または KERB_INTERACTIVE_LOGON。

[in] lpStationName

ユーザーがログオンしたステーションの名前を指定する文字列へのポインター。 ステーション名を使用して、プロバイダー固有の追加情報を取得できるかどうかを判断できます。

Microsoft がプライマリ認証システムの場合は、次のいずれかの文字列が指定されます。

値 意味
WinSta_0
 これは、ウィンドウ ステーションを介した対話型ログオンであることを示します。 この場合、 StationHandle は親ダイアログ ボックスの HWND です。
SvcCtl
 これは、サービス コントローラーによって開始されたログオンであることを示します。 この場合、StationHandle は使用されません。

[in] StationHandle

lpStationName で指定されたステーションの名前 (その結果、型) に依存する意味を持つ 32 ビット値。

値 意味
WinSta_0
 現在画面に表示されている所有者ダイアログ ボックス (hwndOwner) へのハンドル。
SvcCtl
 ランダム なデータ。 使用しないでください。

[in] dwChangeInfo

が設定されている場合は、変更情報を提供するフラグを指定します。 このパラメーターには、いずれかのフラグを指定できます。

値 意味
WN_VALID_LOGON_ACCOUNT
 このフラグは、変更された認証情報が今後のすべてのログオンに影響することを示します。 ユーザーは信頼されたドメインに属しています。
WN_NT_PASSWORD_CHANGED
 このフラグは、パスワードが変更されたことを示します。

一部の認証情報の変更は、信頼されていないドメインで行われた接続にのみ影響します。 これらは、ユーザーがこのコンピューターにログオンするために使用できないアカウントです。 このような場合、 dwChangeInfo は設定されません。

戻り値

関数が成功した場合、関数はWN_SUCCESSを返します。

関数が失敗した場合、エラー コードが返されます。エラー コードは、次のいずれかの値になります。

リターン コード 説明
WN_NOT_SUPPORTED

NPPasswordChangeNotify はサポートされていません。
WN_NO_NETWORK
 ネットワークが存在しません。
WN_FUNCTION_BUSY
 資格情報マネージャーはまだ初期化中であり、呼び出す準備ができていません。

注釈

NPPasswordChangeNotify 関数は、認証情報が変更されたときに通知を受け取るために資格情報マネージャーによって実装されます。

Windows Server 2003 および Windows XP: NPPasswordChangeNotify は、パスワードが別の場所で変更された場合にユーザーがログインしているコンピューターで呼び出されます。 この動作は、Windows Vista および Windows Server 2008 以降ではサポートされないことに注意してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー npapi.h

こちらもご覧ください

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify