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。
関数が失敗した場合、戻り値には次のいずれかのエラー コードを指定できます。
| リターン コード | 説明 |
|---|---|
|
呼び出し元には、操作を完了するための適切なアクセス権がありません。 |
|
パラメーターが正しくありません。 |
|
この要求はサポートされていません。 このエラーは、Windows Vista 以降で返されます。 |
|
ユーザー名が見つかりませんでした。 |
|
ネットワーク ハードウェアで一般的なエラーが発生しました。 |
解説
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 |