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

CREDENTIAL_TARGET_INFORMATIONA

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

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

フィールド

フィールド型サイズx64x86説明
TargetNameLPSTR8/4+0+0対象にアクセスする呼び出し元が指定した、対象サーバーの名前です。通常は対象サーバーの NetBIOS 名または DNS 名です。
NetbiosServerNameLPSTR8/4+8+4対象サーバーの NetBIOS 名です。名前が不明な場合、このメンバーは NULL にできます。
DnsServerNameLPSTR8/4+16+8対象サーバーの DNS 名です。名前が不明な場合、このメンバーは NULL にできます。
NetbiosDomainNameLPSTR8/4+24+12対象サーバーのドメインの NetBIOS 名です。名前が不明な場合、このメンバーは NULL にできます。対象サーバーがワークグループのメンバーである場合、このメンバーは NULL でなければなりません。
DnsDomainNameLPSTR8/4+32+16対象サーバーのドメインの DNS 名です。名前が不明な場合、このメンバーは NULL にできます。対象サーバーがワークグループのメンバーである場合、このメンバーは NULL でなければなりません。
DnsTreeNameLPSTR8/4+40+20対象サーバーのツリーの DNS 名です。ツリー名が不明な場合、このメンバーは NULL にできます。対象サーバーがワークグループのメンバーである場合、このメンバーは NULL でなければなりません。
PackageNameLPSTR8/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 を定義します。エンコードに依存しないエイリアスと、エンコードに依存するコードを混在させて使用すると、不一致が生じてコンパイル エラーや実行時エラーの原因となる可能性があります。詳細については、Conventions for Function Prototypes を参照してください。

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

各言語での定義

#include <windows.h>

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

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CREDENTIAL_TARGET_INFORMATIONA
{
    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_INFORMATIONA
    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_INFORMATIONA(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_INFORMATIONA {
    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_INFORMATIONA struct {
	TargetName uintptr
	NetbiosServerName uintptr
	DnsServerName uintptr
	NetbiosDomainName uintptr
	DnsDomainName uintptr
	DnsTreeName uintptr
	PackageName uintptr
	Flags uint32
	CredTypeCount uint32
	CredTypes uintptr
}
type
  CREDENTIAL_TARGET_INFORMATIONA = 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_INFORMATIONA = 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_INFORMATIONA {.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_INFORMATIONA
{
    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_INFORMATIONA サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; TargetName : LPSTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; NetbiosServerName : LPSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DnsServerName : LPSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; NetbiosDomainName : LPSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; DnsDomainName : LPSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DnsTreeName : LPSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; PackageName : LPSTR (+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_INFORMATIONA サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; TargetName : LPSTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; NetbiosServerName : LPSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; DnsServerName : LPSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; NetbiosDomainName : LPSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; DnsDomainName : LPSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; DnsTreeName : LPSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; PackageName : LPSTR (+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_INFORMATIONA
    #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_INFORMATIONA        ; NSTRUCT 変数を確保
st->Flags = 100
mes "Flags=" + st->Flags