Programming Field - ドキュメント無し関数 / 名前無し関数

SHGetNetResource (#69)

グローバルハンドルに含まれているNRESARRAY構造体からネットリソース(NETRESOURCE)を取得する関数です。

序数 69
DLL Shell32.dll
確認済みOS Windows XP + IE6 sp1

構文

[C/C++]

LONG WINAPI SHGetNetResource(
    HGLOBAL hnres,
    UINT iItem,
    LPNETRESOURCE pnresOut,
    UINT cbMax
);

[VB]

Declare Function SHGetNetResource Lib "shell32.dll" Alias "#69" ( _
    ByVal hnres As Long, _
    ByVal iItem As Long, _
    ByRef pnresOut As NETRESOURCE, _
    ByVal cbMax As Long, _
) As Long

[VB.NET]

Declare Function SHGetNetResource Lib "shell32.dll" Alias "#69" ( _
    ByVal hnres As IntPtr, _
    ByVal iItem As Integer, _
    ByRef pnresOut As NETRESOURCE, _
    ByVal cbMax As Integer, _
) As Integer

パラメータ

hnres NRESARRAY構造体データを持っているグローバルハンドルです。
iItem 取得するNETRESOURCEのインデックスを指定します。-1を指定するとリソースのカウントを取得できます。
pnresOut 取得したリソースを保持するNETRESOURCE構造体のポインタを指定します。この構造体の後ろに文字列が続くので、バッファのサイズは大きく取っておく必要があります。
cbMax pnResOutのバッファサイズを指定します。十分なサイズが指定されているときのみ、pnResOutにデータがコピーされます。

戻り値

iItemが0以上のとき、iItemのリソースのサイズが返ります。

iItemが-1のとき、hnresが保持しているリソースの数(_NRESARRAY::cItems)が返ります。

解説

この関数についてはまだ調査中です。

最終更新日: 2006/08/17