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