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

SHARE_INFO_503

構造体
サイズx64: 80 バイト / x86: 44 バイト

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

フィールド

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

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

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

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

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

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

共有レベルのセキュリティで動作しているサーバーにおける、共有リソースのアクセス許可を示す DWORD 値を指定します。Windows は共有レベルのセキュリティをサポートしていないことに注意してください。このメンバーは、ユーザーレベルのセキュリティで動作しているサーバーでは無視されます。セキュリティ保護可能なオブジェクトへのアクセス制御の詳細については、アクセス制御特権セキュリティ保護可能なオブジェクトを参照してください。

NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。

このメンバーには、次のいずれかの値を指定できます。

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

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

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

shi503_servernameLPWSTR8/4+56+32共有リソースが存在するリモートサーバーの DNS 名または NetBIOS 名を指定する文字列へのポインターです。値が "*" の場合、サーバー名が構成されていないことを示します。
shi503_reservedDWORD4+64+36予約済みです。0 でなければなりません。 NetShareSetInfo 関数の呼び出しでは、このメンバーは無視されます。
shi503_security_descriptorPSECURITY_DESCRIPTOR8/4+72+40この共有に関連付けられた SECURITY_DESCRIPTOR を指定します。

公式ドキュメント

共有リソースに関する情報を格納します。SHARE_INFO_502 構造体と同一ですが、サーバー名も含まれる点が異なります。

解説(Remarks)

shi503_servername メンバーで指定するリモートサーバーは、NetServerTransportAddEx 関数を使用してトランスポートプロトコルにバインドされている必要があります。NetServerTransportAddEx の呼び出しでは、level パラメーターに 2 または 3 を指定し、そのトランスポートプロトコルの SERVER_TRANSPORT_INFO_2 構造体で SVTI2_SCOPED_NAME 値を指定しておく必要があります。

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

各言語での定義

#include <windows.h>

// SHARE_INFO_503  (x64 80 / x86 44 バイト)
typedef struct SHARE_INFO_503 {
    LPWSTR shi503_netname;
    SHARE_TYPE shi503_type;
    LPWSTR shi503_remark;
    SHARE_INFO_PERMISSIONS shi503_permissions;
    DWORD shi503_max_uses;
    DWORD shi503_current_uses;
    LPWSTR shi503_path;
    LPWSTR shi503_passwd;
    LPWSTR shi503_servername;
    DWORD shi503_reserved;
    PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SHARE_INFO_503
{
    public IntPtr shi503_netname;
    public uint shi503_type;
    public IntPtr shi503_remark;
    public uint shi503_permissions;
    public uint shi503_max_uses;
    public uint shi503_current_uses;
    public IntPtr shi503_path;
    public IntPtr shi503_passwd;
    public IntPtr shi503_servername;
    public uint shi503_reserved;
    public IntPtr shi503_security_descriptor;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SHARE_INFO_503
    Public shi503_netname As IntPtr
    Public shi503_type As UInteger
    Public shi503_remark As IntPtr
    Public shi503_permissions As UInteger
    Public shi503_max_uses As UInteger
    Public shi503_current_uses As UInteger
    Public shi503_path As IntPtr
    Public shi503_passwd As IntPtr
    Public shi503_servername As IntPtr
    Public shi503_reserved As UInteger
    Public shi503_security_descriptor As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class SHARE_INFO_503(ctypes.Structure):
    _fields_ = [
        ("shi503_netname", ctypes.c_void_p),
        ("shi503_type", wintypes.DWORD),
        ("shi503_remark", ctypes.c_void_p),
        ("shi503_permissions", wintypes.DWORD),
        ("shi503_max_uses", wintypes.DWORD),
        ("shi503_current_uses", wintypes.DWORD),
        ("shi503_path", ctypes.c_void_p),
        ("shi503_passwd", ctypes.c_void_p),
        ("shi503_servername", ctypes.c_void_p),
        ("shi503_reserved", wintypes.DWORD),
        ("shi503_security_descriptor", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct SHARE_INFO_503 {
    pub shi503_netname: *mut core::ffi::c_void,
    pub shi503_type: u32,
    pub shi503_remark: *mut core::ffi::c_void,
    pub shi503_permissions: u32,
    pub shi503_max_uses: u32,
    pub shi503_current_uses: u32,
    pub shi503_path: *mut core::ffi::c_void,
    pub shi503_passwd: *mut core::ffi::c_void,
    pub shi503_servername: *mut core::ffi::c_void,
    pub shi503_reserved: u32,
    pub shi503_security_descriptor: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type SHARE_INFO_503 struct {
	shi503_netname uintptr
	shi503_type uint32
	shi503_remark uintptr
	shi503_permissions uint32
	shi503_max_uses uint32
	shi503_current_uses uint32
	shi503_path uintptr
	shi503_passwd uintptr
	shi503_servername uintptr
	shi503_reserved uint32
	shi503_security_descriptor uintptr
}
type
  SHARE_INFO_503 = record
    shi503_netname: Pointer;
    shi503_type: DWORD;
    shi503_remark: Pointer;
    shi503_permissions: DWORD;
    shi503_max_uses: DWORD;
    shi503_current_uses: DWORD;
    shi503_path: Pointer;
    shi503_passwd: Pointer;
    shi503_servername: Pointer;
    shi503_reserved: DWORD;
    shi503_security_descriptor: Pointer;
  end;
const SHARE_INFO_503 = extern struct {
    shi503_netname: ?*anyopaque,
    shi503_type: u32,
    shi503_remark: ?*anyopaque,
    shi503_permissions: u32,
    shi503_max_uses: u32,
    shi503_current_uses: u32,
    shi503_path: ?*anyopaque,
    shi503_passwd: ?*anyopaque,
    shi503_servername: ?*anyopaque,
    shi503_reserved: u32,
    shi503_security_descriptor: ?*anyopaque,
};
type
  SHARE_INFO_503 {.bycopy.} = object
    shi503_netname: pointer
    shi503_type: uint32
    shi503_remark: pointer
    shi503_permissions: uint32
    shi503_max_uses: uint32
    shi503_current_uses: uint32
    shi503_path: pointer
    shi503_passwd: pointer
    shi503_servername: pointer
    shi503_reserved: uint32
    shi503_security_descriptor: pointer
struct SHARE_INFO_503
{
    void* shi503_netname;
    uint shi503_type;
    void* shi503_remark;
    uint shi503_permissions;
    uint shi503_max_uses;
    uint shi503_current_uses;
    void* shi503_path;
    void* shi503_passwd;
    void* shi503_servername;
    uint shi503_reserved;
    void* shi503_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_503 サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; shi503_netname : LPWSTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; shi503_type : SHARE_TYPE (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; shi503_remark : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; shi503_permissions : SHARE_INFO_PERMISSIONS (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; shi503_max_uses : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; shi503_current_uses : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; shi503_path : LPWSTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; shi503_passwd : LPWSTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; shi503_servername : LPWSTR (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; shi503_reserved : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; shi503_security_descriptor : PSECURITY_DESCRIPTOR (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SHARE_INFO_503 サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; shi503_netname : LPWSTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; shi503_type : SHARE_TYPE (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; shi503_remark : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; shi503_permissions : SHARE_INFO_PERMISSIONS (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; shi503_max_uses : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; shi503_current_uses : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; shi503_path : LPWSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; shi503_passwd : LPWSTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; shi503_servername : LPWSTR (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; shi503_reserved : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; shi503_security_descriptor : PSECURITY_DESCRIPTOR (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SHARE_INFO_503
    #field intptr shi503_netname
    #field int shi503_type
    #field intptr shi503_remark
    #field int shi503_permissions
    #field int shi503_max_uses
    #field int shi503_current_uses
    #field intptr shi503_path
    #field intptr shi503_passwd
    #field intptr shi503_servername
    #field int shi503_reserved
    #field intptr shi503_security_descriptor
#endstruct

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