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。
関数が失敗した場合、戻り値には次のいずれかのエラー コードを指定できます。
| リターン コード | 説明 |
|---|---|
|
呼び出し元には、操作を完了するための適切なアクセス権がありません。 |
|
パラメーターが正しくありません。 |
|
この要求はサポートされていません。 このエラーは、Windows Vista 以降で返されます。 |
|
コンピューター名でもあるメッセージ エイリアスは削除できません。 |
|
メッセージエイリアスは、すべてのネットワークから正常に削除されませんでした。 |
|
メッセージエイリアスは現在使用中です。 後でもう一度やり直してください。 |
|
メッセージ エイリアスがローカル コンピューターにありません。 |
解説
Administrators ローカル グループのメンバーのみが、リモート サーバーで NetMessageNameDel 関数を正常に実行できます。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | lmmsg.h (include Lm.h) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |