NetMessageNameGetInfo 関数 (lmmsg.h)

  • [アーティクル]

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

NetMessageNameGetInfo 関数は、メッセージ名テーブル内の特定のメッセージ エイリアスに関する情報を取得します。 関数では、メッセンジャー サービスを開始する必要があります。

構文

NET_API_STATUS NET_API_FUNCTION NetMessageNameGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR msgname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

パラメーター

[in] servername

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

[in] msgname

情報を返すメッセージエイリアスを指定する定数文字列へのポインター。

[in] level

データの情報レベルを指定します。 このパラメーターには、次の値のいずれかを指定できます。

値 説明
0
 メッセージエイリアスを返します。 bufptr パラメーターは、MSG_INFO_0構造体を指します。
1
 メッセージエイリアスを返します。 bufptr パラメーターは、MSG_INFO_1構造体を指します。 このレベルは互換性のためにのみ存在します。 メッセージ転送はサポートされていません。

[out] bufptr

データを受信するバッファーへのポインター。 このデータの形式は 、level パラメーターの値によって異なります。 このバッファーはシステムによって割り当てられ、 NetApiBufferFree 関数を使用して解放する必要があります。 詳細については、「 ネットワーク管理機能バッファー 」および「 ネットワーク管理機能バッファーの長さ」を参照してください。

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
 呼び出し元には、操作を完了するための適切なアクセス権がありません。
ERROR_INVALID_LEVEL
 level パラメーターに指定された値が無効です。
ERROR_INVALID_PARAMETER
 パラメーターが正しくありません。
ERROR_NOT_ENOUGH_MEMORY
 十分なメモリがありません。
ERROR_NOT_SUPPORTED
 この要求はサポートされていません。 このエラーは、Windows Vista 以降で返されます。
NERR_NotLocalName
 メッセージ エイリアスがローカル コンピューター上にありません。

解説

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

メッセージ名テーブル内のすべてのメッセージ エイリアスを一覧表示するには、 NetMessageNameEnum 関数を呼び出します。

要件

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

関連項目

MSG_INFO_0

MSG_INFO_1

メッセージ関数

NetMessageNameEnum

ネットワーク管理機能

ネットワーク管理の概要