Win32 API 日本語リファレンス
ホームStorage.FileSystem › SHARE_INFO_502

SHARE_INFO_502

構造体
サイズx64: 72 バイト / x86: 40 バイト

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

フィールド

フィールドサイズx64x86説明
shi502_netnameLPWSTR8/4+0+0共有リソースの名前を指定する Unicode 文字列へのポインターです。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。
shi502_typeSHARE_TYPE4+8+4

共有の種類を指定する値の組み合わせです。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

次の値のいずれかを指定できます。これらの値は STYPE_MASK 値を使用して切り出すことができます。

意味
STYPE_DISKTREE
ディスクドライブ。
STYPE_PRINTQ
印刷キュー。
STYPE_DEVICE
通信デバイス。
STYPE_IPC
プロセス間通信 (IPC)。

さらに、次の値の一方または両方を指定できます。

意味
STYPE_SPECIAL
プロセス間通信 (IPC$) またはサーバーのリモート管理 (ADMIN$) のために予約された特殊な共有です。C$、D$、E$ などの管理共有を指す場合もあります。詳細については、ネットワークの 共有関数を参照してください。
STYPE_TEMPORARY
一時的な共有です。
shi502_remarkLPWSTR8/4+16+8共有リソースに関する省略可能なコメントを指定する Unicode 文字列へのポインターです。
shi502_permissionsSHARE_INFO_PERMISSIONS4+24+12

共有レベルのセキュリティで動作しているサーバーにおける、共有リソースのアクセス許可を示す DWORD 値を指定します。このメンバーは、ユーザーレベルのセキュリティで動作しているサーバーでは無視されます。このメンバーには次のいずれかの値を指定できます。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

Windows は共有レベルのセキュリティをサポートしていないことに注意してください。セキュリティ保護可能なオブジェクトへのアクセス制御の詳細については、Access ControlPrivileges、および Securable Objects を参照してください。

意味
ACCESS_READ
リソースからデータを読み取るアクセス許可です。既定では、リソースを実行するアクセス許可も含まれます。
ACCESS_WRITE
リソースにデータを書き込むアクセス許可です。
ACCESS_CREATE
リソースのインスタンス (ファイルなど) を作成するアクセス許可です。リソースの作成時にデータを書き込むことができます。
ACCESS_EXEC
リソースを実行するアクセス許可です。
ACCESS_DELETE
リソースを削除するアクセス許可です。
ACCESS_ATRIB
リソースの属性 (ファイルが最後に変更された日時など) を変更するアクセス許可です。
ACCESS_PERM
ユーザーまたはアプリケーションに対してリソースに割り当てられているアクセス許可 (読み取り、書き込み、作成、実行、削除) を変更するアクセス許可です。
ACCESS_ALL
リソースの読み取り、書き込み、作成、実行、削除を行い、その属性とアクセス許可を変更するアクセス許可です。
shi502_max_usesDWORD4+28+16共有リソースが受け入れられる同時接続の最大数を示す DWORD 値を指定します。このメンバーに指定された値が –1 の場合、接続数は無制限です。
shi502_current_usesDWORD4+32+20リソースへの現在の接続数を示す DWORD 値を指定します。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。
shi502_pathLPWSTR8/4+40+24共有リソースのローカルパスを格納する Unicode 文字列へのポインターです。ディスクの場合、このメンバーは共有されているパスです。印刷キューの場合、このメンバーは共有されている印刷キューの名前です。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。
shi502_passwdLPWSTR8/4+48+28

共有のパスワードを指定する Unicode 文字列へのポインターです (サーバーが共有レベルのセキュリティで動作している場合)。サーバーがユーザーレベルのセキュリティで動作している場合、このメンバーは無視されます。Windows は共有レベルのセキュリティをサポートしていないことに注意してください。

このメンバーは SHPWLEN+1 バイト (終端の null 文字を含む) を超えることはできません。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

shi502_reservedDWORD4+56+32予約済みです。0 でなければなりません。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。
shi502_security_descriptorPSECURITY_DESCRIPTOR8/4+64+36この共有に関連付けられている SECURITY_DESCRIPTOR を指定します。

公式ドキュメント

共有リソースに関する情報 (リソース名、種類とアクセス許可、接続数、その他の関連情報) を格納します。

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

各言語での定義

#include <windows.h>

// SHARE_INFO_502  (x64 72 / x86 40 バイト)
typedef struct SHARE_INFO_502 {
    LPWSTR shi502_netname;
    SHARE_TYPE shi502_type;
    LPWSTR shi502_remark;
    SHARE_INFO_PERMISSIONS shi502_permissions;
    DWORD shi502_max_uses;
    DWORD shi502_current_uses;
    LPWSTR shi502_path;
    LPWSTR shi502_passwd;
    DWORD shi502_reserved;
    PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SHARE_INFO_502
{
    public IntPtr shi502_netname;
    public uint shi502_type;
    public IntPtr shi502_remark;
    public uint shi502_permissions;
    public uint shi502_max_uses;
    public uint shi502_current_uses;
    public IntPtr shi502_path;
    public IntPtr shi502_passwd;
    public uint shi502_reserved;
    public IntPtr shi502_security_descriptor;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SHARE_INFO_502
    Public shi502_netname As IntPtr
    Public shi502_type As UInteger
    Public shi502_remark As IntPtr
    Public shi502_permissions As UInteger
    Public shi502_max_uses As UInteger
    Public shi502_current_uses As UInteger
    Public shi502_path As IntPtr
    Public shi502_passwd As IntPtr
    Public shi502_reserved As UInteger
    Public shi502_security_descriptor As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class SHARE_INFO_502(ctypes.Structure):
    _fields_ = [
        ("shi502_netname", ctypes.c_void_p),
        ("shi502_type", wintypes.DWORD),
        ("shi502_remark", ctypes.c_void_p),
        ("shi502_permissions", wintypes.DWORD),
        ("shi502_max_uses", wintypes.DWORD),
        ("shi502_current_uses", wintypes.DWORD),
        ("shi502_path", ctypes.c_void_p),
        ("shi502_passwd", ctypes.c_void_p),
        ("shi502_reserved", wintypes.DWORD),
        ("shi502_security_descriptor", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct SHARE_INFO_502 {
    pub shi502_netname: *mut core::ffi::c_void,
    pub shi502_type: u32,
    pub shi502_remark: *mut core::ffi::c_void,
    pub shi502_permissions: u32,
    pub shi502_max_uses: u32,
    pub shi502_current_uses: u32,
    pub shi502_path: *mut core::ffi::c_void,
    pub shi502_passwd: *mut core::ffi::c_void,
    pub shi502_reserved: u32,
    pub shi502_security_descriptor: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type SHARE_INFO_502 struct {
	shi502_netname uintptr
	shi502_type uint32
	shi502_remark uintptr
	shi502_permissions uint32
	shi502_max_uses uint32
	shi502_current_uses uint32
	shi502_path uintptr
	shi502_passwd uintptr
	shi502_reserved uint32
	shi502_security_descriptor uintptr
}
type
  SHARE_INFO_502 = record
    shi502_netname: Pointer;
    shi502_type: DWORD;
    shi502_remark: Pointer;
    shi502_permissions: DWORD;
    shi502_max_uses: DWORD;
    shi502_current_uses: DWORD;
    shi502_path: Pointer;
    shi502_passwd: Pointer;
    shi502_reserved: DWORD;
    shi502_security_descriptor: Pointer;
  end;
const SHARE_INFO_502 = extern struct {
    shi502_netname: ?*anyopaque,
    shi502_type: u32,
    shi502_remark: ?*anyopaque,
    shi502_permissions: u32,
    shi502_max_uses: u32,
    shi502_current_uses: u32,
    shi502_path: ?*anyopaque,
    shi502_passwd: ?*anyopaque,
    shi502_reserved: u32,
    shi502_security_descriptor: ?*anyopaque,
};
type
  SHARE_INFO_502 {.bycopy.} = object
    shi502_netname: pointer
    shi502_type: uint32
    shi502_remark: pointer
    shi502_permissions: uint32
    shi502_max_uses: uint32
    shi502_current_uses: uint32
    shi502_path: pointer
    shi502_passwd: pointer
    shi502_reserved: uint32
    shi502_security_descriptor: pointer
struct SHARE_INFO_502
{
    void* shi502_netname;
    uint shi502_type;
    void* shi502_remark;
    uint shi502_permissions;
    uint shi502_max_uses;
    uint shi502_current_uses;
    void* shi502_path;
    void* shi502_passwd;
    uint shi502_reserved;
    void* shi502_security_descriptor;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SHARE_INFO_502 サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; shi502_netname : LPWSTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; shi502_type : SHARE_TYPE (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; shi502_remark : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; shi502_permissions : SHARE_INFO_PERMISSIONS (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; shi502_max_uses : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; shi502_current_uses : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; shi502_path : LPWSTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; shi502_passwd : LPWSTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; shi502_reserved : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; shi502_security_descriptor : PSECURITY_DESCRIPTOR (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SHARE_INFO_502 サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; shi502_netname : LPWSTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; shi502_type : SHARE_TYPE (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; shi502_remark : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; shi502_permissions : SHARE_INFO_PERMISSIONS (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; shi502_max_uses : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; shi502_current_uses : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; shi502_path : LPWSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; shi502_passwd : LPWSTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; shi502_reserved : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; shi502_security_descriptor : PSECURITY_DESCRIPTOR (+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 SHARE_INFO_502
    #field intptr shi502_netname
    #field int shi502_type
    #field intptr shi502_remark
    #field int shi502_permissions
    #field int shi502_max_uses
    #field int shi502_current_uses
    #field intptr shi502_path
    #field intptr shi502_passwd
    #field int shi502_reserved
    #field intptr shi502_security_descriptor
#endstruct

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