Win32 API 日本語リファレンス
ホーム › Security.Credentials › CREDENTIAL_TARGET_INFORMATIONW

CREDENTIAL_TARGET_INFORMATIONW

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 72 バイト / x86: 40 バイト

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

フィールド

フィールド型サイズx64x86説明
TargetNameLPWSTR8/4+0+0対象にアクセスする呼び出し元が指定した、ターゲット サーバーの名前です。通常はターゲット サーバーの NetBIOS 名または DNS 名です。
NetbiosServerNameLPWSTR8/4+8+4ターゲット サーバーの NetBIOS 名です。名前が不明な場合、このメンバーは NULL にできます。
DnsServerNameLPWSTR8/4+16+8ターゲット サーバーの DNS 名です。名前が不明な場合、このメンバーは NULL にできます。
NetbiosDomainNameLPWSTR8/4+24+12ターゲット サーバーのドメインの NetBIOS 名です。名前が不明な場合、このメンバーは NULL にできます。ターゲット サーバーがワークグループのメンバーである場合、このメンバーは NULL でなければなりません。
DnsDomainNameLPWSTR8/4+32+16ターゲット サーバーのドメインの DNS 名です。名前が不明な場合、このメンバーは NULL にできます。ターゲット サーバーがワークグループのメンバーである場合、このメンバーは NULL でなければなりません。
DnsTreeNameLPWSTR8/4+40+20ターゲット サーバーのツリーの DNS 名です。ツリー名が不明な場合、このメンバーは NULL にできます。ターゲット サーバーがワークグループのメンバーである場合、このメンバーは NULL でなければなりません。
PackageNameLPWSTR8/4+48+24TargetName をもとに NetbiosServerName、DnsServerName、NetbiosDomainName、DnsDomainName、DnsTreeName の各値を決定した認証パッケージの名前です。このメンバーは AcquireCredentialsHandle にパッケージ名として渡すことができます。
FlagsDWORD4+56+28

対象の属性です。

  • CRED_TI_SERVER_FORMAT_UNKNOWN

    (1) — 認証パッケージがサーバー名を DNS 名と NetBIOS 名のどちらであるか判断できない場合に設定されます。この場合、NetbiosServerName メンバーは NULL に設定され、DnsServerName メンバーには形式が不明なサーバー名が設定されます。

  • CRED_TI_DOMAIN_FORMAT_UNKNOWN

    (2) — 認証パッケージがドメイン名を DNS 名と NetBIOS 名のどちらであるか判断できない場合に設定されます。この場合、NetbiosDomainName メンバーは NULL に設定され、DnsDomainName メンバーには形式が不明なドメイン名が設定されます。

  • CRED_TI_ONLY_PASSWORD_REQUIRED

    (4) — 認証パッケージが、そのサーバーの認証にはパスワードのみが必要であると判断した場合に設定されます。呼び出し元はこのフラグを利用して、ユーザー名を求めずにパスワードのみの入力を求めることができます。

    保存される資格情報には UserName メンバーが必要です。これらのサーバーには <DnsServerName>\Guest または <NetbiosServerName>\Guest という値を使用してください。

CredTypeCountDWORD4+60+32CredTypes 配列の要素数です。
CredTypesDWORD*8/4+64+36ターゲット サーバーが使用する認証パッケージで受け入れ可能な資格情報の種類を指定する配列です。各要素は CRED_TYPE_* 定義のいずれかです。この配列の順序は、認証パッケージの優先順位を表します。優先度の高い種類ほどリストの前方に指定されます。

公式ドキュメント

CREDENTIAL_TARGET_INFORMATION 構造体は、対象コンピューターの名前、ドメイン、ツリーを格納します。

解説(Remarks)

メモ

wincred.h ヘッダーは、UNICODE プリプロセッサ定数の定義に応じてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして CREDENTIAL_TARGET_INFORMATION を定義します。このエンコーディング中立のエイリアスを、エンコーディング中立でないコードと混在させて使用すると、不一致が生じてコンパイル エラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則 を参照してください。

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

各言語での定義

#include <windows.h>

// CREDENTIAL_TARGET_INFORMATIONW  (x64 72 / x86 40 バイト)
typedef struct CREDENTIAL_TARGET_INFORMATIONW {
    LPWSTR TargetName;
    LPWSTR NetbiosServerName;
    LPWSTR DnsServerName;
    LPWSTR NetbiosDomainName;
    LPWSTR DnsDomainName;
    LPWSTR DnsTreeName;
    LPWSTR PackageName;
    DWORD Flags;
    DWORD CredTypeCount;
    DWORD* CredTypes;
} CREDENTIAL_TARGET_INFORMATIONW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CREDENTIAL_TARGET_INFORMATIONW
{
    public IntPtr TargetName;
    public IntPtr NetbiosServerName;
    public IntPtr DnsServerName;
    public IntPtr NetbiosDomainName;
    public IntPtr DnsDomainName;
    public IntPtr DnsTreeName;
    public IntPtr PackageName;
    public uint Flags;
    public uint CredTypeCount;
    public IntPtr CredTypes;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CREDENTIAL_TARGET_INFORMATIONW
    Public TargetName As IntPtr
    Public NetbiosServerName As IntPtr
    Public DnsServerName As IntPtr
    Public NetbiosDomainName As IntPtr
    Public DnsDomainName As IntPtr
    Public DnsTreeName As IntPtr
    Public PackageName As IntPtr
    Public Flags As UInteger
    Public CredTypeCount As UInteger
    Public CredTypes As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class CREDENTIAL_TARGET_INFORMATIONW(ctypes.Structure):
    _fields_ = [
        ("TargetName", ctypes.c_void_p),
        ("NetbiosServerName", ctypes.c_void_p),
        ("DnsServerName", ctypes.c_void_p),
        ("NetbiosDomainName", ctypes.c_void_p),
        ("DnsDomainName", ctypes.c_void_p),
        ("DnsTreeName", ctypes.c_void_p),
        ("PackageName", ctypes.c_void_p),
        ("Flags", wintypes.DWORD),
        ("CredTypeCount", wintypes.DWORD),
        ("CredTypes", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct CREDENTIAL_TARGET_INFORMATIONW {
    pub TargetName: *mut core::ffi::c_void,
    pub NetbiosServerName: *mut core::ffi::c_void,
    pub DnsServerName: *mut core::ffi::c_void,
    pub NetbiosDomainName: *mut core::ffi::c_void,
    pub DnsDomainName: *mut core::ffi::c_void,
    pub DnsTreeName: *mut core::ffi::c_void,
    pub PackageName: *mut core::ffi::c_void,
    pub Flags: u32,
    pub CredTypeCount: u32,
    pub CredTypes: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type CREDENTIAL_TARGET_INFORMATIONW struct {
	TargetName uintptr
	NetbiosServerName uintptr
	DnsServerName uintptr
	NetbiosDomainName uintptr
	DnsDomainName uintptr
	DnsTreeName uintptr
	PackageName uintptr
	Flags uint32
	CredTypeCount uint32
	CredTypes uintptr
}
type
  CREDENTIAL_TARGET_INFORMATIONW = record
    TargetName: Pointer;
    NetbiosServerName: Pointer;
    DnsServerName: Pointer;
    NetbiosDomainName: Pointer;
    DnsDomainName: Pointer;
    DnsTreeName: Pointer;
    PackageName: Pointer;
    Flags: DWORD;
    CredTypeCount: DWORD;
    CredTypes: Pointer;
  end;
const CREDENTIAL_TARGET_INFORMATIONW = extern struct {
    TargetName: ?*anyopaque,
    NetbiosServerName: ?*anyopaque,
    DnsServerName: ?*anyopaque,
    NetbiosDomainName: ?*anyopaque,
    DnsDomainName: ?*anyopaque,
    DnsTreeName: ?*anyopaque,
    PackageName: ?*anyopaque,
    Flags: u32,
    CredTypeCount: u32,
    CredTypes: ?*anyopaque,
};
type
  CREDENTIAL_TARGET_INFORMATIONW {.bycopy.} = object
    TargetName: pointer
    NetbiosServerName: pointer
    DnsServerName: pointer
    NetbiosDomainName: pointer
    DnsDomainName: pointer
    DnsTreeName: pointer
    PackageName: pointer
    Flags: uint32
    CredTypeCount: uint32
    CredTypes: pointer
struct CREDENTIAL_TARGET_INFORMATIONW
{
    void* TargetName;
    void* NetbiosServerName;
    void* DnsServerName;
    void* NetbiosDomainName;
    void* DnsDomainName;
    void* DnsTreeName;
    void* PackageName;
    uint Flags;
    uint CredTypeCount;
    void* CredTypes;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CREDENTIAL_TARGET_INFORMATIONW サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; TargetName : LPWSTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; NetbiosServerName : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DnsServerName : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; NetbiosDomainName : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; DnsDomainName : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DnsTreeName : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; PackageName : LPWSTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Flags : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; CredTypeCount : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; CredTypes : DWORD* (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CREDENTIAL_TARGET_INFORMATIONW サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; TargetName : LPWSTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; NetbiosServerName : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; DnsServerName : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; NetbiosDomainName : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; DnsDomainName : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; DnsTreeName : LPWSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; PackageName : LPWSTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; Flags : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; CredTypeCount : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; CredTypes : DWORD* (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CREDENTIAL_TARGET_INFORMATIONW
    #field intptr TargetName
    #field intptr NetbiosServerName
    #field intptr DnsServerName
    #field intptr NetbiosDomainName
    #field intptr DnsDomainName
    #field intptr DnsTreeName
    #field intptr PackageName
    #field int Flags
    #field int CredTypeCount
    #field intptr CredTypes
#endstruct

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