次の方法で共有


NetShareDelEx 関数 (lmshare.h)

サーバーの共有リソースの一覧から共有名を削除します。これにより、その共有へのすべての接続が切断されます。 この関数は、 NetShareDel 関数の拡張バージョンであり、呼び出し元は 、SHARE_INFO_0SHARE_INFO_1、SHARE_INFO_2SHARE_INFO_502、または SHARE_INFO_503構造体 指定できます。

構文

NET_API_STATUS NET_API_FUNCTION NetShareDelEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE buf
);

パラメーター

[in] servername

関数を実行するリモート サーバーの DNS または NetBIOS 名を指定する文字列へのポインター。 このパラメーターが NULL の場合は、ローカル コンピューターが使用されます。

_WIN32_WINNTまたはFORCE_UNICODEが定義されている場合、この文字列は Unicode です。

[in] level

データの情報レベルを指定します。 このパラメーターには、次の値のいずれかを指定できます。

意味
0、1、2、または 502
リソースの名前、種類とアクセス許可、接続数など、共有リソースに関する情報を指定します。 buf パラメーターは、SHARE_INFO_0、SHARE_INFO_1SHARE_INFO_2、またはSHARE_INFO_502構造体指します。
503
リソースの名前、種類とアクセス許可、接続の数、およびその他の関連情報など、共有リソースに関する情報を指定します。 buf パラメーターは、SHARE_INFO_503構造体を指します。

[in] buf

データを指定するバッファーへのポインター。 このデータの形式は 、level パラメーターの値によって異なります。 詳細については、「 ネットワーク管理機能バッファー」を参照してください。

戻り値

関数が成功した場合、戻り値はNERR_Success。

関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。

リターン コード 説明
ERROR_INTERNAL_ERROR
内部エラーが発生しました。
ERROR_INVALID_LEVEL
level パラメーターに指定された値が無効です。
ERROR_NOT_SUPPORTED
要求はサポートされていません。

注釈

level パラメーターに 503 が指定されている場合、buf パラメーターはSHARE_INFO_503構造体を指し、その構造体のshi503_netnameメンバーとshi503_servernameメンバーを使用してサーバー上の共有リソースを検索します。他のメンバーは無視されます。 shi503_servername メンバーで指定されたリモート サーバーは、NetServerTransportAddEx 関数を使用してトランスポート プロトコルにバインドされている必要があります。 NetServerTransportAddEx の呼び出しでは、level パラメーターに 2 または 3 を指定し、トランスポート プロトコルのSERVER_TRANSPORT_INFO_2構造でSVTI2_SCOPED_NAME フラグを指定する必要があります。

level パラメーターに 0、1、2、または 502 を指定した場合、buf パラメーターはSHARE_INFO_0SHARE_INFO_1SHARE_INFO_2、またはSHARE_INFO_502構造体を指し、その構造体のshi0_netnameshi1_netnameshi2_netname、またはshi502_netnameメンバーが使用されます。他のメンバーは無視されます。

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー lmshare.h (Lm.h を含む)
Library Netapi32.lib
[DLL] Netapi32.dll

こちらもご覧ください

NetServerTransportAddEx

NetShareAdd

NetShareDel

ネットワーク管理機能

ネットワーク管理の概要

ネットワーク共有関数

SHARE_INFO_0

SHARE_INFO_1

SHARE_INFO_2

SHARE_INFO_502

SHARE_INFO_503