NetMessageNameEnum

NetMessageNameEnum 関数は、指定したコンピューターでメッセージを受信するメッセージエイリアスの一覧を取得する。この関数は messenger サービスが開始されている必要がある。

NetMessageNameEnum servername, level, bufptr, prefmaxlen, entriesread, totalentries, resume_handle

servername : [wstr] 関数を実行するリモートサーバーの DNS または NetBIOS 名を指定する定数文字列へのポインタ。このパラメータが NULL の場合、ローカルコンピューターが使われる。
level : [int] 
bufptr : [var] データを受け取るバッファへのポインタ。このデータの形式は level パラメータの値に依存する。このバッファはシステムによって割り当てられ、NetApiBufferFree 関数で解放しなければならない。関数が ERROR_MORE_DATA で失敗した場合でもバッファを解放する必要がある点に注意。
prefmaxlen : [int] 返されるデータの望ましい最大長をバイト単位で指定する。MAX_PREFERRED_LENGTH を指定すると、関数は必要な量のメモリを割り当てる。別の値を指定すると、関数が返すバイト数を制限できる。バッファサイズがすべてのエントリを保持するのに不十分な場合、関数は ERROR_MORE_DATA を返す。詳細は Network Management Function Buffers および Network Management Function Buffer Lengths を参照。
entriesread : [var] 実際に列挙された要素数を受け取る値へのポインタ。
totalentries : [var] 現在の再開位置から列挙可能だったエントリの総数を受け取る値へのポインタ。アプリケーションはこの値を目安としてのみ扱うべきである点に注意。
resume_handle : [var] 既存のメッセージエイリアス検索を継続するために使われる再開ハンドルを格納する値へのポインタ。最初の呼び出しではハンドルを 0 にし、以降の呼び出しでは変更せずに渡す。resume_handle が NULL の場合、再開ハンドルは格納されない。

(プラグイン / モジュール : netapi32.dll)

解説

NetMessageNameEnum 関数は、指定したコンピューターでメッセージを受信するメッセージエイリアスの一覧を取得する。この関数は
messenger サービスが開始されている必要がある。

[戻り値]
関数が成功した場合、戻り値は NERR_Success となる。失敗した場合、戻り値は次のいずれかのエラーコードになる可能性がある。
（以下省略）

[備考]
リモートサーバー上で NetMessageNameEnum 関数を正常に実行できるのは、Administrators
ローカルグループのメンバーだけである。メッセージ名テーブル内の特定のメッセージエイリアスの情報を取得するには、NetMessageNameGetInfo
関数を呼び出せる。

情報