NETRESOURCEW 構造体 (winnetwk.h)

  • [アーティクル]

次の構造体には、ネットワーク リソースに関する情報が含まれています。 NPOpenEnum や NPAddConnection など、いくつかのネットワーク プロバイダー関数で使用されます。

構文

typedef struct _NETRESOURCEW {
  DWORD  dwScope;
  DWORD  dwType;
  DWORD  dwDisplayType;
  DWORD  dwUsage;
  LPWSTR lpLocalName;
  LPWSTR lpRemoteName;
  LPWSTR lpComment;
  LPWSTR lpProvider;
} NETRESOURCEW, *LPNETRESOURCEW;

メンバー

dwScope

列挙体のスコープを示します。 これには、次のいずれかの値を指定できます。

値 意味
RESOURCE_CONNECTED
 ネットワーク リソースへの現在の接続。
RESOURCE_GLOBALNET
 すべてのネットワーク リソース。 これらは、接続されている場合と接続されていない場合があります。
RESOURCE_CONTEXT
 ユーザーの現在および既定のネットワーク コンテキストに関連付けられているネットワーク リソース。 この意味はプロバイダー固有です。

dwType

リソースの種類を示します。 これには、次のいずれかの値を指定できます。

値 意味
RESOURCETYPE_DISK
 リソースは共有ディスク ボリュームです。
RESOURCETYPE_PRINT
 リソースは共有プリンターです。
RESOURCETYPE_ANY
 リソースは、印刷リソースとディスク リソースの両方のコンテナー、または印刷またはディスク以外のリソースなど、複数の種類に一致します。

dwDisplayType

このリソースを表すためにユーザー インターフェイスで使用する必要がある表示の種類を示すようにプロバイダーによって設定されます。 次の型が定義されています。

値 意味
RESOURCEDISPLAYTYPE_NETWORK
 リソースはネットワーク プロバイダーです。
RESOURCEDISPLAYTYPE_DOMAIN
 リソースはサーバーのコレクションです。
RESOURCEDISPLAYTYPE_SERVER
 リソースはサーバーです。
RESOURCEDISPLAYTYPE_SHARE
 リソースは共有ポイントです。
RESOURCEDISPLAYTYPE_DIRECTORY
 リソースはディレクトリです。
RESOURCEDISPLAYTYPE_GENERIC
 リソースの種類が指定されていません。 この値は、リソースの種類を指定しないネットワーク プロバイダーによって使用されます。

dwUsage

リソースに関する情報を列挙する方法を示すビットマスク。 dwScope が RESOURCE_GLOBALNET に設定されている場合にのみ定義されます。 dwUsage フィールドには、次のフラグを 1 つ以上含めることができます。

値 意味
RESOURCEUSAGE_CONNECTABLE
 リソースに接続するには、 NPAddConnection を呼び出します。 dwType がRESOURCETYPE_DISKの場合、リソースに接続した後、FindFirstFile や FindNextFile などのファイル システム API を使用して、リソースに含まれるすべてのファイルとディレクトリを列挙できます。
RESOURCEUSAGE_CONTAINER
 リソースは、 NPOpenEnum、 NPEnumResource、および NPCloseEnum 関数を使用して列挙できる他のリソースのコンテナーです。

ただし、列挙が行われた時点でコンテナーが空になる場合があります。 つまり、 NPEnumResource の最初の呼び出しでは、WN_NO_MORE_ENTRIESが返される場合があります。

lpLocalName

dwScope がRESOURCE_CONNECTEDの場合、lpLocalName フィールドにはリダイレクトされたデバイスの名前が含まれます。 接続がデバイスレス接続の場合、このフィールドには NULL が含まれます。

dwScope が RESOURCE_CONNECTED に設定されていない場合、このフィールドは未定義です。

lpRemoteName

列挙項目がネットワーク リソースの場合、このフィールドにはリモート ネットワーク名が含まれます。 dwUsage が RESOURCEUSAGE_CONNECTABLE に設定されている場合、この名前を NPAddConnection に渡してネットワーク接続を確立できます。 列挙項目が現在の接続である場合、このフィールドは lpLocalName が接続されているリモート ネットワーク名を参照します。

lpComment

列挙項目に関連付けられているプロバイダー指定のコメントを指定できます。

lpProvider

この列挙項目を所有するプロバイダーの名前を指定します。

注釈

注意

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header winnetwk.h