NetEnumerateComputerNames 関数 (lmjoin.h)
NetEnumerateComputerNames 関数は、指定したコンピューターの名前を列挙します。
構文
NET_API_STATUS NET_API_FUNCTION NetEnumerateComputerNames(
[in, optional] LPCWSTR Server,
[in] NET_COMPUTER_NAME_TYPE NameType,
[in] ULONG Reserved,
[out] PDWORD EntryCount,
[out] LPWSTR **ComputerNames
);
パラメーター
[in, optional] Server
この関数を実行するコンピューターの名前を指定する定数文字列へのポインター。 このパラメーターが NULL の場合は、ローカル コンピューターが使用されます。
[in] NameType
照会された名前の型。 このメンバーには、Lmjoin.h ヘッダー ファイルで定義されているNET_COMPUTER_NAME_TYPE列挙で定義されている次のいずれかの値を指定できます。
| 値 | 説明 |
|---|---|
|
プライマリ コンピューター名。 |
|
代替コンピューター名。 |
|
すべてのコンピューター名。 |
|
クエリを実行する名前の種類に使用できる値を指定する範囲の末尾を示します。 |
[in] Reserved
将来利用するために予約されています。 このパラメーターは NULL にする必要があります。
[out] EntryCount
関数が成功した場合に ComputerNames パラメーターによって指されるバッファーで返される名前の数を返す DWORD 値へのポインター。
[out] ComputerNames
名前へのポインターの配列へのポインター。 関数呼び出しが成功した場合、このパラメーターは NameType パラメーターで指定されたコンピューターの種類名と一致するコンピューター名を返します。
アプリケーションでこの配列が不要になった場合は、 NetApiBufferFree 関数を呼び出してこのバッファーを解放する必要があります。
戻り値
関数が成功した場合、戻り値はNERR_Success。
関数が失敗した場合、戻り値には、次のいずれかのエラー コードまたは システム エラー コードのいずれかを指定できます。
| リターン コード | 説明 |
|---|---|
|
アクセスが拒否されました。 このエラーは、呼び出し元がターゲット コンピューター上の Administrators ローカル グループのメンバーでない場合に返されます。 |
|
パラメーターが正しくありません。 |
|
このコマンドを処理するのに十分なメモリがありません。 |
|
要求はサポートされていません。 この関数を実行する Server パラメーターで指定されたターゲット コンピューターが Windows 2000 以前で実行されている場合、このエラーが返されます。 |
|
ワークステーション サービスが開始されていません。 |
|
このスレッドでリモート プロシージャ コールが既に進行中です。 |
|
リモート プロシージャ コール プロトコル シーケンスはサポートされていません。 |
解説
NetEnumerateComputerNames 関数は、Windows Vista 以降でサポートされています。
NetEnumerateComputerNames 関数は、コンピューターが現在構成している名前を要求するために使用されます。
NetEnumerateComputerNames 関数では、呼び出し元がターゲット コンピューター上の Administrators ローカル グループのメンバーである必要があります。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | lmjoin.h (include Lm.h) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |