DS_SCHEMA_GUID_MAPW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| guid | GUID | 16 | +0 | +0 | オブジェクトの GUID を指定する GUID 構造体です。 |
| guidType | DWORD | 4 | +16 | +16 | DsMapSchemaGuids によってマップされた GUID の種類を示します。 DS_SCHEMA_GUID_ATTRこの GUID はプロパティを識別します。 DS_SCHEMA_GUID_ATTR_SETこの GUID はプロパティ セットを識別します。 DS_SCHEMA_GUID_CLASSこの GUID はオブジェクトの種類を識別します。 DS_SCHEMA_GUID_CONTROL_RIGHTこの GUID は拡張アクセス権を識別します。 DS_SCHEMA_GUID_NOT_FOUNDこの GUID はディレクトリ サービス スキーマ内に見つかりません。 |
| pName | LPWSTR | 8/4 | +24 | +20 | GUID に関連付けられた表示名を指定する、NULL で終わる文字列値へのポインターです。DsMapSchemaGuids が GUID を表示名にマップできなかった場合、この値は NULL になることがあります。 - guidType.DS_SCHEMA_GUID_ATTRこの GUID はプロパティを識別します。 - guidType.DS_SCHEMA_GUID_ATTR_SETこの GUID はプロパティ セットを識別します。 - guidType.DS_SCHEMA_GUID_CLASSこの GUID はオブジェクトの種類を識別します。 - guidType.DS_SCHEMA_GUID_CONTROL_RIGHTこの GUID は拡張アクセス権を識別します。 - guidType.DS_SCHEMA_GUID_NOT_FOUNDこの GUID はディレクトリ サービス スキーマ内に見つかりません。 |
公式ドキュメント
DS_SCHEMA_GUID_MAP 構造体は、 DsMapSchemaGuids の呼び出し結果を格納します。DsMapSchemaGuids が GUID のマッピングに成功した場合、DS_SCHEMA_GUID_MAP には GUID と、その GUID が参照するオブジェクトの表示名の両方が格納されます。
解説(Remarks)
ntdsapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして DS_SCHEMA_GUID_MAP を定義しています。エンコーディング中立のエイリアスの使用と、エンコーディング中立でないコードを混在させると、不一致が生じてコンパイル エラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則 を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DS_SCHEMA_GUID_MAPW (x64 32 / x86 24 バイト)
typedef struct DS_SCHEMA_GUID_MAPW {
GUID guid;
DWORD guidType;
LPWSTR pName;
} DS_SCHEMA_GUID_MAPW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DS_SCHEMA_GUID_MAPW
{
public Guid guid;
public uint guidType;
public IntPtr pName;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DS_SCHEMA_GUID_MAPW
Public guid As Guid
Public guidType As UInteger
Public pName As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class DS_SCHEMA_GUID_MAPW(ctypes.Structure):
_fields_ = [
("guid", GUID),
("guidType", wintypes.DWORD),
("pName", ctypes.c_void_p),
]#[repr(C)]
pub struct DS_SCHEMA_GUID_MAPW {
pub guid: GUID,
pub guidType: u32,
pub pName: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type DS_SCHEMA_GUID_MAPW struct {
guid windows.GUID
guidType uint32
pName uintptr
}type
DS_SCHEMA_GUID_MAPW = record
guid: TGUID;
guidType: DWORD;
pName: Pointer;
end;const DS_SCHEMA_GUID_MAPW = extern struct {
guid: GUID,
guidType: u32,
pName: ?*anyopaque,
};type
DS_SCHEMA_GUID_MAPW {.bycopy.} = object
guid: GUID
guidType: uint32
pName: pointerstruct DS_SCHEMA_GUID_MAPW
{
GUID guid;
uint guidType;
void* pName;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DS_SCHEMA_GUID_MAPW サイズ: 24 バイト(x86)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; guid : GUID (+0, 16byte) varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; guidType : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; pName : LPWSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DS_SCHEMA_GUID_MAPW サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; guid : GUID (+0, 16byte) varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; guidType : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; pName : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
#field int Data1
#field short Data2
#field short Data3
#field byte Data4 8
#endstruct
#defstruct global DS_SCHEMA_GUID_MAPW
#field GUID guid
#field int guidType
#field intptr pName
#endstruct
stdim st, DS_SCHEMA_GUID_MAPW ; NSTRUCT 変数を確保
st->guidType = 100
mes "guidType=" + st->guidType