Win32 API 日本語リファレンス
ホーム › Networking.HttpServer › HTTP_COOKED_URL

HTTP_COOKED_URL

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

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

フィールド

フィールド型サイズx64x86説明
FullUrlLengthWORD2+0+0pFullUrl メンバーが指すデータのサイズ (バイト単位)。終端の null 文字は含みません。
HostLengthWORD2+2+2pHost メンバーが指すデータのサイズ (バイト単位)。
AbsPathLengthWORD2+4+4pAbsPath メンバーが指すデータのサイズ (バイト単位)。
QueryStringLengthWORD2+6+6pQueryString メンバーが指すデータのサイズ (バイト単位)。
pFullUrlLPWSTR8/4+8+8URL の先頭にあるスキーム要素へのポインター ("http://..." または "https://..." のいずれかでなければなりません)。
pHostLPWSTR8/4+16+12スキーム要素の末尾にある二重スラッシュの直後に続く、ホスト要素の最初の文字へのポインター。
pAbsPathLPWSTR8/4+24+16文字列内の 3 番目のスラッシュ ("/") へのポインター。UrlPrefix 文字列では、これは relativeUri 要素の直前にあるスラッシュです。
pQueryStringLPWSTR8/4+32+20文字列内の最初の疑問符 (?) へのポインター。疑問符が存在しない場合は NULL です。

公式ドキュメント

HTTP_COOKED_URL 構造体は、検証済みで正規化された UTF-16 Unicode エンコードの URL 要求文字列を、その文字列内を指すポインターおよび各要素の長さとともに格納します。これは、要求を適切にルーティングするために HTTP Server API が登録済みの UrlPrefix 文字列と照合する文字列です。

解説(Remarks)

たとえば、pFullUrl が "http://www.fabrikam.com/path1/path2/file.ext?n1=v1&n2=v2" である場合、pHost は "www.fabrikam" を指し、pAbsPath は "/path1/…" を指し、pQueryString は "?n1=v1…" を指します。

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

各言語での定義

#include <windows.h>

// HTTP_COOKED_URL  (x64 40 / x86 24 バイト)
typedef struct HTTP_COOKED_URL {
    WORD FullUrlLength;
    WORD HostLength;
    WORD AbsPathLength;
    WORD QueryStringLength;
    LPWSTR pFullUrl;
    LPWSTR pHost;
    LPWSTR pAbsPath;
    LPWSTR pQueryString;
} HTTP_COOKED_URL;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_COOKED_URL
{
    public ushort FullUrlLength;
    public ushort HostLength;
    public ushort AbsPathLength;
    public ushort QueryStringLength;
    public IntPtr pFullUrl;
    public IntPtr pHost;
    public IntPtr pAbsPath;
    public IntPtr pQueryString;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_COOKED_URL
    Public FullUrlLength As UShort
    Public HostLength As UShort
    Public AbsPathLength As UShort
    Public QueryStringLength As UShort
    Public pFullUrl As IntPtr
    Public pHost As IntPtr
    Public pAbsPath As IntPtr
    Public pQueryString As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class HTTP_COOKED_URL(ctypes.Structure):
    _fields_ = [
        ("FullUrlLength", ctypes.c_ushort),
        ("HostLength", ctypes.c_ushort),
        ("AbsPathLength", ctypes.c_ushort),
        ("QueryStringLength", ctypes.c_ushort),
        ("pFullUrl", ctypes.c_void_p),
        ("pHost", ctypes.c_void_p),
        ("pAbsPath", ctypes.c_void_p),
        ("pQueryString", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct HTTP_COOKED_URL {
    pub FullUrlLength: u16,
    pub HostLength: u16,
    pub AbsPathLength: u16,
    pub QueryStringLength: u16,
    pub pFullUrl: *mut core::ffi::c_void,
    pub pHost: *mut core::ffi::c_void,
    pub pAbsPath: *mut core::ffi::c_void,
    pub pQueryString: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type HTTP_COOKED_URL struct {
	FullUrlLength uint16
	HostLength uint16
	AbsPathLength uint16
	QueryStringLength uint16
	pFullUrl uintptr
	pHost uintptr
	pAbsPath uintptr
	pQueryString uintptr
}
type
  HTTP_COOKED_URL = record
    FullUrlLength: Word;
    HostLength: Word;
    AbsPathLength: Word;
    QueryStringLength: Word;
    pFullUrl: Pointer;
    pHost: Pointer;
    pAbsPath: Pointer;
    pQueryString: Pointer;
  end;
const HTTP_COOKED_URL = extern struct {
    FullUrlLength: u16,
    HostLength: u16,
    AbsPathLength: u16,
    QueryStringLength: u16,
    pFullUrl: ?*anyopaque,
    pHost: ?*anyopaque,
    pAbsPath: ?*anyopaque,
    pQueryString: ?*anyopaque,
};
type
  HTTP_COOKED_URL {.bycopy.} = object
    FullUrlLength: uint16
    HostLength: uint16
    AbsPathLength: uint16
    QueryStringLength: uint16
    pFullUrl: pointer
    pHost: pointer
    pAbsPath: pointer
    pQueryString: pointer
struct HTTP_COOKED_URL
{
    ushort FullUrlLength;
    ushort HostLength;
    ushort AbsPathLength;
    ushort QueryStringLength;
    void* pFullUrl;
    void* pHost;
    void* pAbsPath;
    void* pQueryString;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; HTTP_COOKED_URL サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; FullUrlLength : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; HostLength : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; AbsPathLength : WORD (+4, 2byte)  wpoke st,4,値  /  値 = wpeek(st,4)
; QueryStringLength : WORD (+6, 2byte)  wpoke st,6,値  /  値 = wpeek(st,6)
; pFullUrl : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pHost : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pAbsPath : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pQueryString : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; HTTP_COOKED_URL サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; FullUrlLength : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; HostLength : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; AbsPathLength : WORD (+4, 2byte)  wpoke st,4,値  /  値 = wpeek(st,4)
; QueryStringLength : WORD (+6, 2byte)  wpoke st,6,値  /  値 = wpeek(st,6)
; pFullUrl : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pHost : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pAbsPath : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; pQueryString : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global HTTP_COOKED_URL
    #field short FullUrlLength
    #field short HostLength
    #field short AbsPathLength
    #field short QueryStringLength
    #field intptr pFullUrl
    #field intptr pHost
    #field intptr pAbsPath
    #field intptr pQueryString
#endstruct

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