ホーム › Networking.WinSock › ASSOCIATE_NAMERES_CONTEXT_INPUT
ASSOCIATE_NAMERES_CONTEXT_INPUT
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| TransportSettingId | TRANSPORT_SETTING_ID | 16 | +0 | +0 | トランスポート設定 ID です。 |
| Handle | ULONGLONG | 8 | +16 | +16 | 完全修飾ドメイン名へのハンドルです。 |
公式ドキュメント
ASSOCIATE_NAMERES_CONTEXT_INPUT 構造体は、トランスポート設定 ID と、完全修飾ドメイン名へのハンドルを格納します。
解説(Remarks)
一般に、ASSOCIATE_NAMERES_CONTEXT_INPUT を使用すると、単なる IP アドレスではなく完全修飾ドメイン名 (FQDN) に基づいてポリシーを適用できます。そのためには、addinfoex4 構造体を使用して GetAddrInfoEx を呼び出し、FQDN へのハンドルを取得します。次に、そのハンドルを ASSOCIATE_NAMERES_CONTEXT_INPUT に設定し、SIO_APPLY_TRANSPORT_SETTING ioctl を指定して WSAIoctl を呼び出します。
例
次のコードは、addinfoex4 構造体を指定して GetAddrInfoEx を呼び出し、FQDN へのハンドルを取得する方法を示しています。続いてこのサンプルは、ASSOCIATE_NAMERES_CONTEXT_INPUT 構造体を指定して WSAIoctl を呼び出します。
//
// Connect to a server using its IPv4 addresses
//
VOID
ConnectServer(
PCWSTR server)
{
int iResult;
PADDRINFOEX4 pResult = NULL;
ADDRINFOEX3 hints = { 0 };
PADDRINFOEX4 pCur = NULL;
WSADATA wsaData;
SOCKET connectSocket = INVALID_SOCKET;
ULONG bytesReturned = 0;
ASSOCIATE_NAMERES_CONTEXT_INPUT input = { 0 };
SOCKADDR_IN clientService;
wchar_t ipstringbuffer[46];
String string;
DWORD dwRetval;
//
// Initialize Winsock
//
iResult = WSAStartup(
MAKEWORD(2, 2),
&wsaData);
if (iResult != 0) {
printf("WSAStartup failed: %d\n", iResult);
goto Exit;
}
//
// Create a SOCKET for connection
//
connectSocket = socket(
AF_UNSPEC,
SOCK_STREAM,
IPPROTO_TCP);
if (connectSocket == INVALID_SOCKET)
{
printf("socket failed: %d\n", WSAGetLastError());
goto Exit;
}
//
// Do name resolution
//
hints.ai_family = AF_INET;
hints.ai_socktype = SOCK_STREAM;
hints.ai_flags = AI_EXTENDED | AI_FQDN | AI_CANONNAME | AI_RESOLUTION_HANDLE;
hints.ai_version = ADDRINFOEX_VERSION_4;
dwRetval = GetAddrInfoExW(
server,
NULL,
NS_DNS,
NULL,
(const ADDRINFOEXW*)&hints,
(PADDRINFOEXW*)&pResult,
NULL,
NULL,
NULL, NULL);
if (dwRetval != 0) {
printf("GetAddrInfoEx failed with error: %d\n", dwRetval);
goto Exit;
}
input.TransportSettingId.Guid = ASSOCIATE_NAMERES_CONTEXT;
input.Handle = pResult->ai_resolutionhandle;
//
// Associate socket with the handle
//
if (WSAIoctl(
connectSocket,
SIO_APPLY_TRANSPORT_SETTING,
(VOID *)&input,
sizeof(input),
NULL,
0,
&bytesReturned,
NULL,
NULL) == SOCKET_ERROR)
if (iResult != 0){
printf("WSAIoctl failed: %d\n", WSAGetLastError());
goto Exit;
}
//
// Connect to server
//
pCur = pResult;
while (pCur != NULL)
{
if (pCur->ai_addr->sa_family == AF_INET)
{
clientService = *(const sockaddr_in*)pCur->ai_addr;
clientService.sin_port = htons(80);
if (connect(
connectSocket,
(const SOCKADDR *)&clientService,
sizeof(clientService)) == SOCKET_ERROR)
{
printf("connect failed: %d\n", WSAGetLastError());
goto Exit;
}
}
pCur = pCur->ai_next;
}
Exit:
if (connectSocket != INVALID_SOCKET)
{
closesocket(connectSocket);
}
if (pResult)
{
FreeAddrInfoExW((ADDRINFOEXW*)pResult);
}
WSACleanup();
return;
}
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// TRANSPORT_SETTING_ID (x64 16 / x86 16 バイト)
typedef struct TRANSPORT_SETTING_ID {
GUID Guid;
} TRANSPORT_SETTING_ID;
// ASSOCIATE_NAMERES_CONTEXT_INPUT (x64 24 / x86 24 バイト)
typedef struct ASSOCIATE_NAMERES_CONTEXT_INPUT {
TRANSPORT_SETTING_ID TransportSettingId;
ULONGLONG Handle;
} ASSOCIATE_NAMERES_CONTEXT_INPUT;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct TRANSPORT_SETTING_ID
{
public Guid Guid;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ASSOCIATE_NAMERES_CONTEXT_INPUT
{
public TRANSPORT_SETTING_ID TransportSettingId;
public ulong Handle;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure TRANSPORT_SETTING_ID
Public Guid As Guid
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ASSOCIATE_NAMERES_CONTEXT_INPUT
Public TransportSettingId As TRANSPORT_SETTING_ID
Public Handle As ULong
End Structureimport ctypes
from ctypes import wintypes
class TRANSPORT_SETTING_ID(ctypes.Structure):
_fields_ = [
("Guid", GUID),
]
class ASSOCIATE_NAMERES_CONTEXT_INPUT(ctypes.Structure):
_fields_ = [
("TransportSettingId", TRANSPORT_SETTING_ID),
("Handle", ctypes.c_ulonglong),
]#[repr(C)]
pub struct TRANSPORT_SETTING_ID {
pub Guid: GUID,
}
#[repr(C)]
pub struct ASSOCIATE_NAMERES_CONTEXT_INPUT {
pub TransportSettingId: TRANSPORT_SETTING_ID,
pub Handle: u64,
}import "golang.org/x/sys/windows"
type TRANSPORT_SETTING_ID struct {
Guid windows.GUID
}
type ASSOCIATE_NAMERES_CONTEXT_INPUT struct {
TransportSettingId TRANSPORT_SETTING_ID
Handle uint64
}type
TRANSPORT_SETTING_ID = record
Guid: TGUID;
end;
ASSOCIATE_NAMERES_CONTEXT_INPUT = record
TransportSettingId: TRANSPORT_SETTING_ID;
Handle: UInt64;
end;const TRANSPORT_SETTING_ID = extern struct {
Guid: GUID,
};
const ASSOCIATE_NAMERES_CONTEXT_INPUT = extern struct {
TransportSettingId: TRANSPORT_SETTING_ID,
Handle: u64,
};type
TRANSPORT_SETTING_ID {.bycopy.} = object
Guid: GUID
ASSOCIATE_NAMERES_CONTEXT_INPUT {.bycopy.} = object
TransportSettingId: TRANSPORT_SETTING_ID
Handle: uint64struct TRANSPORT_SETTING_ID
{
GUID Guid;
}
struct ASSOCIATE_NAMERES_CONTEXT_INPUT
{
TRANSPORT_SETTING_ID TransportSettingId;
ulong Handle;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ASSOCIATE_NAMERES_CONTEXT_INPUT サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; TransportSettingId : TRANSPORT_SETTING_ID (+0, 16byte) varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; Handle : ULONGLONG (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ※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 TRANSPORT_SETTING_ID
#field GUID Guid
#endstruct
#defstruct global ASSOCIATE_NAMERES_CONTEXT_INPUT
#field TRANSPORT_SETTING_ID TransportSettingId
#field int64 Handle
#endstruct
stdim st, ASSOCIATE_NAMERES_CONTEXT_INPUT ; NSTRUCT 変数を確保
st->Handle = 100
mes "Handle=" + st->Handle