NetMessageBufferSend 関数 (lmmsg.h)

  • [アーティクル]

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

NetMessageBufferSend 関数は、登録されたメッセージ エイリアスに情報のバッファーを送信します。

構文

NET_API_STATUS NET_API_FUNCTION NetMessageBufferSend(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname,
  [in] LPCWSTR fromname,
  [in] LPBYTE  buf,
  [in] DWORD   buflen
);

パラメーター

[in] servername

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

[in] msgname

メッセージ バッファーの送信先となるメッセージエイリアスを指定する定数文字列へのポインター。

[in] fromname

メッセージの取得元を指定する定数文字列へのポインター。 このパラメーターが NULL の場合、メッセージはローカル コンピューター名から送信されます。

[in] buf

メッセージ テキストを含むバッファーへのポインター。 詳細については、「 ネットワーク管理関数バッファー」を参照してください。

[in] buflen

buf パラメーターが指すメッセージ・テキストの長さをバイト単位で含む値を指定します。

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
 呼び出し元には、操作を完了するための適切なアクセス権がありません。
ERROR_INVALID_PARAMETER
 パラメーターが正しくありません。
ERROR_NOT_SUPPORTED
 この要求はサポートされていません。 このエラーは、Windows Vista 以降で返されます。
NERR_NameNotFound
 ユーザー名が見つかりませんでした。
NERR_NetworkError
 ネットワーク ハードウェアで一般的なエラーが発生しました。

解説

Active Directory を実行しているドメイン コントローラーでこの関数を呼び出すと、セキュリティ保護可能なオブジェクトのアクセス制御リスト (ACL) に基づいてアクセスが許可または拒否されます。 既定の ACL では、Domain Admins と Account Operators のみがこの関数を呼び出すように許可されます。 メンバー サーバーまたはワークステーションでは、管理者とサーバーオペレーターのみがこの関数を呼び出すことができます。 詳細については、「 ネットワーク管理機能のセキュリティ要件」を参照してください。 ACL と ACE の詳細については、「存取控制 モデル」を参照してください。

要件

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

関連項目

メッセージ関数

NetMessageNameAdd

NetMessageNameDel

NetMessageNameEnum

NetMessageNameGetInfo

ネットワーク管理機能

ネットワーク管理の概要