ホーム › NetworkManagement.NetManagement › NET_VALIDATE_OUTPUT_ARG

NET_VALIDATE_OUTPUT_ARG

構造体

📘 Microsoft Learn (日本語) · English

サイズx64: 56 バイト / x86: 44 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

型

サイズ

x64

x86

説明

ChangedPersistedFields

NET_VALIDATE_PERSISTED_FIELDS

48/40

ログオン対象のアカウントに関する永続的な情報の変更を格納する構造体です。詳細については、後述の「解説」セクションを参照してください。

ValidationStatus

DWORD

+48

+40

NetValidatePasswordPolicy 関数によって実行されたパスワード検証チェックの結果です。ステータスは、この関数の ValidationType パラメーターに指定した値によって異なります。

認証。 NetValidatePasswordPolicy を呼び出し、ValidationType パラメーターに NetValidateAuthentication を指定した場合、このメンバーは次のいずれかの値になります。

値	意味
NERR_AccountLockedOut	検証に失敗しました。アカウントがロックアウトされています。
NERR_PasswordMustChange	検証に失敗しました。次回のログオン時にパスワードを変更する必要があります。
NERR_PasswordExpired	検証に失敗しました。パスワードの有効期限が切れています。
NERR_BadPassword	検証に失敗しました。パスワードが無効です。
NERR_Success	パスワードは検証チェックに合格しました。

パスワードの変更。 NetValidatePasswordPolicy を呼び出し、ValidationType パラメーターに NetValidatePasswordChange を指定した場合、このメンバーは次のいずれかの値になります。

値	意味
NERR_AccountLockedOut	検証に失敗しました。アカウントがロックアウトされています。
NERR_PasswordTooRecent	検証に失敗しました。このユーザーのパスワードは変更されてから間もないため、変更できません。
NERR_BadPassword	検証に失敗しました。パスワードが無効です。
NERR_PasswordHistConflict	検証に失敗しました。このパスワードは現時点では使用できません。
NERR_PasswordTooShort	検証に失敗しました。パスワードが短すぎるため、ポリシーの要件を満たしていません。
NERR_PasswordTooLong	検証に失敗しました。パスワードが長すぎるため、ポリシーの要件を満たしていません。
NERR_PasswordNotComplexEnough	検証に失敗しました。パスワードの複雑さが十分でないため、ポリシーの要件を満たしていません。
NERR_PasswordFilterError	検証に失敗しました。パスワードがパスワードフィルター DLL の要件を満たしていません。
NERR_Success	パスワードは検証チェックに合格しました。

パスワードのリセット。 NetValidatePasswordPolicy を呼び出し、ValidationType パラメーターに NetValidatePasswordReset を指定した場合、このメンバーは次のいずれかの値になります。

値	意味
NERR_PasswordTooShort	検証に失敗しました。パスワードが短すぎるため、ポリシーの要件を満たしていません。
NERR_PasswordTooLong	検証に失敗しました。パスワードが長すぎるため、ポリシーの要件を満たしていません。
NERR_PasswordNotComplexEnough	検証に失敗しました。パスワードの複雑さが十分でないため、ポリシーの要件を満たしていません。
NERR_PasswordFilterError	検証に失敗しました。パスワードがパスワードフィルター DLL の要件を満たしていません。
NERR_Success	パスワードは検証チェックに合格しました。

公式ドキュメント

NET_VALIDATE_OUTPUT_ARG 構造体は、ユーザーの前回のログオン以降に変更された永続的なパスワード関連データに関する情報と、関数によるパスワード検証チェックの結果を格納します。

解説(Remarks)

NetValidatePasswordPolicy 関数は、NET_VALIDATE_OUTPUT_ARG 構造体を出力します。

NET_VALIDATE_OUTPUT_ARG 構造体の ChangedPersistedFields メンバーに含まれるすべてのデータと、User オブジェクトの情報を保存するのは、アプリケーションの責任である点に注意してください。次にアプリケーションが同じ User オブジェクトのインスタンスに対して NetValidatePasswordPolicy を呼び出す際には、アプリケーションは永続的な情報から必要なフィールドを提供しなければなりません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// FILETIME  (x64 8 / x86 8 バイト)
typedef struct FILETIME {
    DWORD dwLowDateTime;
    DWORD dwHighDateTime;
} FILETIME;

// NET_VALIDATE_PERSISTED_FIELDS  (x64 48 / x86 40 バイト)
typedef struct NET_VALIDATE_PERSISTED_FIELDS {
    DWORD PresentFields;
    FILETIME PasswordLastSet;
    FILETIME BadPasswordTime;
    FILETIME LockoutTime;
    DWORD BadPasswordCount;
    DWORD PasswordHistoryLength;
    NET_VALIDATE_PASSWORD_HASH* PasswordHistory;
} NET_VALIDATE_PERSISTED_FIELDS;

// NET_VALIDATE_OUTPUT_ARG  (x64 56 / x86 44 バイト)
typedef struct NET_VALIDATE_OUTPUT_ARG {
    NET_VALIDATE_PERSISTED_FIELDS ChangedPersistedFields;
    DWORD ValidationStatus;
} NET_VALIDATE_OUTPUT_ARG;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NET_VALIDATE_PERSISTED_FIELDS
{
    public uint PresentFields;
    public FILETIME PasswordLastSet;
    public FILETIME BadPasswordTime;
    public FILETIME LockoutTime;
    public uint BadPasswordCount;
    public uint PasswordHistoryLength;
    public IntPtr PasswordHistory;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NET_VALIDATE_OUTPUT_ARG
{
    public NET_VALIDATE_PERSISTED_FIELDS ChangedPersistedFields;
    public uint ValidationStatus;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILETIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NET_VALIDATE_PERSISTED_FIELDS
    Public PresentFields As UInteger
    Public PasswordLastSet As FILETIME
    Public BadPasswordTime As FILETIME
    Public LockoutTime As FILETIME
    Public BadPasswordCount As UInteger
    Public PasswordHistoryLength As UInteger
    Public PasswordHistory As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NET_VALIDATE_OUTPUT_ARG
    Public ChangedPersistedFields As NET_VALIDATE_PERSISTED_FIELDS
    Public ValidationStatus As UInteger
End Structure

import ctypes
from ctypes import wintypes

class FILETIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class NET_VALIDATE_PERSISTED_FIELDS(ctypes.Structure):
    _fields_ = [
        ("PresentFields", wintypes.DWORD),
        ("PasswordLastSet", FILETIME),
        ("BadPasswordTime", FILETIME),
        ("LockoutTime", FILETIME),
        ("BadPasswordCount", wintypes.DWORD),
        ("PasswordHistoryLength", wintypes.DWORD),
        ("PasswordHistory", ctypes.c_void_p),
    ]

class NET_VALIDATE_OUTPUT_ARG(ctypes.Structure):
    _fields_ = [
        ("ChangedPersistedFields", NET_VALIDATE_PERSISTED_FIELDS),
        ("ValidationStatus", wintypes.DWORD),
    ]

#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct NET_VALIDATE_PERSISTED_FIELDS {
    pub PresentFields: u32,
    pub PasswordLastSet: FILETIME,
    pub BadPasswordTime: FILETIME,
    pub LockoutTime: FILETIME,
    pub BadPasswordCount: u32,
    pub PasswordHistoryLength: u32,
    pub PasswordHistory: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct NET_VALIDATE_OUTPUT_ARG {
    pub ChangedPersistedFields: NET_VALIDATE_PERSISTED_FIELDS,
    pub ValidationStatus: u32,
}

import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type NET_VALIDATE_PERSISTED_FIELDS struct {
	PresentFields uint32
	PasswordLastSet FILETIME
	BadPasswordTime FILETIME
	LockoutTime FILETIME
	BadPasswordCount uint32
	PasswordHistoryLength uint32
	PasswordHistory uintptr
}

type NET_VALIDATE_OUTPUT_ARG struct {
	ChangedPersistedFields NET_VALIDATE_PERSISTED_FIELDS
	ValidationStatus uint32
}

type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  NET_VALIDATE_PERSISTED_FIELDS = record
    PresentFields: DWORD;
    PasswordLastSet: FILETIME;
    BadPasswordTime: FILETIME;
    LockoutTime: FILETIME;
    BadPasswordCount: DWORD;
    PasswordHistoryLength: DWORD;
    PasswordHistory: Pointer;
  end;

  NET_VALIDATE_OUTPUT_ARG = record
    ChangedPersistedFields: NET_VALIDATE_PERSISTED_FIELDS;
    ValidationStatus: DWORD;
  end;

const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const NET_VALIDATE_PERSISTED_FIELDS = extern struct {
    PresentFields: u32,
    PasswordLastSet: FILETIME,
    BadPasswordTime: FILETIME,
    LockoutTime: FILETIME,
    BadPasswordCount: u32,
    PasswordHistoryLength: u32,
    PasswordHistory: ?*anyopaque,
};

const NET_VALIDATE_OUTPUT_ARG = extern struct {
    ChangedPersistedFields: NET_VALIDATE_PERSISTED_FIELDS,
    ValidationStatus: u32,
};

type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  NET_VALIDATE_PERSISTED_FIELDS {.bycopy.} = object
    PresentFields: uint32
    PasswordLastSet: FILETIME
    BadPasswordTime: FILETIME
    LockoutTime: FILETIME
    BadPasswordCount: uint32
    PasswordHistoryLength: uint32
    PasswordHistory: pointer

  NET_VALIDATE_OUTPUT_ARG {.bycopy.} = object
    ChangedPersistedFields: NET_VALIDATE_PERSISTED_FIELDS
    ValidationStatus: uint32

struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct NET_VALIDATE_PERSISTED_FIELDS
{
    uint PresentFields;
    FILETIME PasswordLastSet;
    FILETIME BadPasswordTime;
    FILETIME LockoutTime;
    uint BadPasswordCount;
    uint PasswordHistoryLength;
    void* PasswordHistory;
}

struct NET_VALIDATE_OUTPUT_ARG
{
    NET_VALIDATE_PERSISTED_FIELDS ChangedPersistedFields;
    uint ValidationStatus;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NET_VALIDATE_OUTPUT_ARG サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; ChangedPersistedFields : NET_VALIDATE_PERSISTED_FIELDS (+0, 40byte)  varptr(st)+0 を基点に操作(40byte:入れ子/配列)
; ValidationStatus : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NET_VALIDATE_OUTPUT_ARG サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; ChangedPersistedFields : NET_VALIDATE_PERSISTED_FIELDS (+0, 48byte)  varptr(st)+0 を基点に操作(48byte:入れ子/配列)
; ValidationStatus : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global NET_VALIDATE_PERSISTED_FIELDS
    #field int PresentFields
    #field FILETIME PasswordLastSet
    #field FILETIME BadPasswordTime
    #field FILETIME LockoutTime
    #field int BadPasswordCount
    #field int PasswordHistoryLength
    #field intptr PasswordHistory
#endstruct

#defstruct global NET_VALIDATE_OUTPUT_ARG
    #field NET_VALIDATE_PERSISTED_FIELDS ChangedPersistedFields
    #field int ValidationStatus
#endstruct

stdim st, NET_VALIDATE_OUTPUT_ARG        ; NSTRUCT 変数を確保
st->ValidationStatus = 100
mes "ValidationStatus=" + st->ValidationStatus