NetMessageNameDel 関数 (lmmsg.h)

  • [アーティクル]

[この関数は、メッセンジャー サービスがサポートされていないため、Windows Vista の時点ではサポートされていません。]

NetMessageNameDel 関数は、メッセージ名テーブル内のメッセージ エイリアスを削除します。 関数では、Messenger サービスを開始する必要があります。

構文

NET_API_STATUS NET_API_FUNCTION NetMessageNameDel(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname
);

パラメーター

[in] servername

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

[in] msgname

削除するメッセージエイリアスを指定する定数文字列へのポインター。 文字列の長さは 15 文字以下です。

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
 呼び出し元には、操作を完了するための適切なアクセス権がありません。
ERROR_INVALID_PARAMETER
 パラメーターが正しくありません。
ERROR_NOT_SUPPORTED
 この要求はサポートされていません。 このエラーは、Windows Vista 以降で返されます。
NERR_DelComputerName
 コンピューター名でもあるメッセージ エイリアスは削除できません。
NERR_IncompleteDel
 メッセージエイリアスは、すべてのネットワークから正常に削除されませんでした。
NERR_NameInUse
 メッセージエイリアスは現在使用中です。 後でもう一度やり直してください。
NERR_NotLocalName
 メッセージ エイリアスがローカル コンピューターにありません。

解説

Administrators ローカル グループのメンバーのみが、リモート サーバーで NetMessageNameDel 関数を正常に実行できます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー lmmsg.h (include Lm.h)
Library Netapi32.lib
[DLL] Netapi32.dll

関連項目

メッセージ関数

NetMessageNameAdd

ネットワーク管理機能

ネットワーク管理の概要