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。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
リターン コード | 説明 |
---|---|
|
呼び出し元には、操作を完了するための適切なアクセス権がありません。 |
|
パラメーターが正しくありません。 |
|
この要求はサポートされていません。 このエラーは、Windows Vista 以降で返されます。 |
|
メッセージ エイリアスは、このコンピューターに既に存在します。 詳細については、「解説」を参照してください。 |
|
指定された名前は、ネットワーク上のメッセージ エイリアスとして既に使用されています。 |
|
ネットワーク ハードウェアで一般的なエラーが発生しました。 |
|
メッセージ エイリアスの最大数を超えました。 |
注釈
リモート サーバーで 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 |