次の方法で共有

NETRESOURCEA 構造体 (winnetwk.h)

  • [アーティクル]

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

構文

typedef struct _NETRESOURCEA {
  DWORD dwScope;
  DWORD dwType;
  DWORD dwDisplayType;
  DWORD dwUsage;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  LPSTR lpComment;
  LPSTR lpProvider;
} NETRESOURCEA, *LPNETRESOURCEA;

メンバーズ

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

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

lpComment

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

lpProvider

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

備考

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー winnetwk.h