NetShareDelEx 関数 (lmshare.h)

[アーティクル]
03/05/2024

サーバーの共有リソースの一覧から共有名を削除します。これにより、その共有へのすべての接続が切断されます。この関数は、 NetShareDel 関数の拡張バージョンであり、呼び出し元は、SHARE_INFO_0、 SHARE_INFO_1、SHARE_INFO_2、 SHARE_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_1、SHARE_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_0、SHARE_INFO_1、SHARE_INFO_2、またはSHARE_INFO_502構造体を指し、その構造体のshi0_netname、shi1_netname、shi2_netname、またはshi502_netnameメンバーが使用されます。他のメンバーは無視されます。

要件

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