NetMessageNameAdd 関数 (lmmsg.h)

  • [アーティクル]

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

NetMessageNameAdd 関数は、メッセージ名テーブルにメッセージ エイリアスを登録します。 関数では、メッセンジャー サービスを開始する必要があります。

構文

NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
  [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_AlreadyExists
 メッセージ エイリアスは、このコンピューターに既に存在します。 詳細については、「解説」を参照してください。
NERR_DuplicateName
 指定された名前は、ネットワーク上のメッセージ エイリアスとして既に使用されています。
NERR_NetworkError
 ネットワーク ハードウェアで一般的なエラーが発生しました。
NERR_TooManyNames
 メッセージ エイリアスの最大数を超えました。

注釈

リモート サーバーで NetMessageNameAdd 関数を正常に実行できるのは、Administrators ローカル グループのメンバーだけです。

転送アクション・フラグは LAN Manager 2 のパラメーターではなくなりました。メッセージ転送がサポートされなくなったため、x NetMessageNameAdd 関数。 NetMessageNameAdd 関数が、転送されたバージョンの msgname がネットワーク上に存在することを検出した場合、関数はエラー NERR_Already_Existsで失敗します。

要件

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

こちらもご覧ください

メッセージ関数

NetMessageNameDel

ネットワーク管理機能

ネットワーク管理の概要