次の方法で共有

WNetEnumResourceA 関数 (winnetwk.h)

  • [アーティクル]

WNetEnumResource 関数は、WNetOpenEnum 関数の呼び出しによって開始されたネットワーク リソースの列挙を続行します。

構文

DWORD WNetEnumResourceA(
  [in]      HANDLE  hEnum,
  [in, out] LPDWORD lpcCount,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

パラメーター

[in] hEnum

列挙インスタンスを識別するハンドル。 このハンドルは、WNetOpenEnum 関数によって返される必要があります。

[in, out] lpcCount

要求されたエントリの数を指定する変数へのポインター。 要求された数が –1 の場合、関数はできるだけ多くのエントリを返します。

関数が成功した場合、このパラメーターが指す変数を返すと、実際に読み取られたエントリの数が含まれます。

[out] lpBuffer

列挙結果を受け取るバッファーへのポインター。 結果は、NETRESOURCE 構造体 配列として返されます。 割り当てるバッファーは、構造体とメンバーが指す文字列を保持するのに十分な大きさである必要があることに注意してください。 詳細については、次の「解説」セクションを参照してください。

バッファーは、hEnum パラメーターで指定されたハンドルを使用した次の呼び出しまで有効です。 配列内 NETRESOURCE 構造体の順序は予測できません。

[in, out] lpBufferSize

lpBuffer パラメーターのサイズをバイト単位で指定する変数へのポインター。 バッファーが小さすぎて 1 つのエントリを受信するには、このパラメーターはバッファーの必要なサイズを受け取ります。

戻り値

関数が成功した場合、戻り値は次のいずれかの値になります。

リターン コード 形容
NO_ERROR
 列挙が成功し、バッファーに要求されたデータが含まれています。 呼び出し元のアプリケーションは、WNetEnumResource 呼び出し続けて列挙を完了できます。
ERROR_NO_MORE_ITEMS
 これ以上エントリはありません。 バッファーの内容は未定義です。
 

関数が失敗した場合、戻り値は システム エラー コード(次のいずれかの値など) です。

リターン コード 形容
ERROR_MORE_DATA
 後続の呼び出しでは、さらに多くのエントリを使用できます。 詳細については、次の「解説」セクションを参照してください。
ERROR_INVALID_HANDLE
 hEnum パラメーターで指定されたハンドルが無効です。
ERROR_NO_NETWORK
 ネットワークは使用できません。 (この条件は、hEnum が有効性 テストされる前にテストされます)。
ERROR_EXTENDED_ERROR
 ネットワーク固有のエラーが発生しました。 エラーの説明を取得するには、WNetGetLastError 関数を呼び出します。

備考

WNetEnumResource 関数は、共有に接続されているユーザーを列挙しません。このタスクを実行するには、NetConnectionEnum 関数を呼び出すことができます。 非表示の共有を列挙するには、NetShareEnum 関数を呼び出します。

アプリケーションでは、lpBuffer パラメーターを NULL を し、lpBufferSize パラメーターから必要なバッファー サイズを取得することはできません。 代わりに、アプリケーションは妥当なサイズ (通常は 16 KB) のバッファーを割り当て、エラー検出に lpBufferSize 値を使用する必要があります。

例

ネットワーク上のすべてのリソースを列挙するアプリケーション定義関数を示すコード サンプルについては、「ネットワーク リソースの列挙参照してください。

手記

winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WNetEnumResource を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winnetwk.h
ライブラリ Mpr.lib
DLL Mpr.dll

関連項目

NETRESOURCE の

WNetCloseEnum の

WNetOpenEnum を する

Windows ネットワーク (WNet) の概要

Windows ネットワーク機能の