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列挙で定義されている次のいずれかの値を指定できます。

値 説明
NetPrimaryComputerName
 プライマリ コンピューター名。
NetAlternateComputerNames
 代替コンピューター名。
NetAllComputerNames
 すべてのコンピューター名。
NetComputerNameTypeMax
 クエリを実行する名前の種類に使用できる値を指定する範囲の末尾を示します。

[in] Reserved

将来利用するために予約されています。 このパラメーターは NULL にする必要があります。

[out] EntryCount

関数が成功した場合に ComputerNames パラメーターによって指されるバッファーで返される名前の数を返す DWORD 値へのポインター。

[out] ComputerNames

名前へのポインターの配列へのポインター。 関数呼び出しが成功した場合、このパラメーターは NameType パラメーターで指定されたコンピューターの種類名と一致するコンピューター名を返します。

アプリケーションでこの配列が不要になった場合は、 NetApiBufferFree 関数を呼び出してこのバッファーを解放する必要があります。

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
 アクセスが拒否されました。 このエラーは、呼び出し元がターゲット コンピューター上の Administrators ローカル グループのメンバーでない場合に返されます。
ERROR_INVALID_PARAMETER
 パラメーターが正しくありません。
ERROR_NOT_ENOUGH_MEMORY
 このコマンドを処理するのに十分なメモリがありません。
ERROR_NOT_SUPPORTED
 要求はサポートされていません。 この関数を実行する Server パラメーターで指定されたターゲット コンピューターが Windows 2000 以前で実行されている場合、このエラーが返されます。
NERR_WkstaNotStarted
 ワークステーション サービスが開始されていません。
RPC_S_CALL_IN_PROGRESS
 このスレッドでリモート プロシージャ コールが既に進行中です。
RPC_S_PROTSEQ_NOT_SUPPORTED
 リモート プロシージャ コール プロトコル シーケンスはサポートされていません。

解説

NetEnumerateComputerNames 関数は、Windows Vista 以降でサポートされています。

NetEnumerateComputerNames 関数は、コンピューターが現在構成している名前を要求するために使用されます。

NetEnumerateComputerNames 関数では、呼び出し元がターゲット コンピューター上の Administrators ローカル グループのメンバーである必要があります。

要件

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

関連項目

NetAddAlternateComputerName

NetJoinDomain

NetRemoveAlternateComputerName

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx