NetGetJoinInformation 関数 (lmjoin.h)

  • [アーティクル]

NetGetJoinInformation 関数は、指定されたコンピューターの結合状態情報を取得します。

構文

NET_API_STATUS NET_API_FUNCTION NetGetJoinInformation(
  [in]  LPCWSTR               lpServer,
  [out] LPWSTR                *lpNameBuffer,
  [out] PNETSETUP_JOIN_STATUS BufferType
);

パラメーター

[in] lpServer

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

[out] lpNameBuffer

コンピューターが参加しているドメインまたはワークグループの NetBIOS 名を受け取るバッファーへのポインター。 このバッファーはシステムによって割り当てられ、 NetApiBufferFree 関数を使用して解放する必要があります。 詳細については、「 ネットワーク管理機能バッファー 」および「 ネットワーク管理機能バッファーの長さ」を参照してください。

[out] BufferType

指定したコンピューターの参加状態を受け取ります。 このパラメーターには、次のいずれかの値を指定できます。

typedef enum _NETSETUP_JOIN_STATUS {

    NetSetupUnknownStatus = 0,
    NetSetupUnjoined,
    NetSetupWorkgroupName,
    NetSetupDomainName

} NETSETUP_JOIN_STATUS, *PNETSETUP_JOIN_STATUS;

これらの値には、次の意味があります。

値 説明
NetSetupUnknownStatus
 状態が不明です。
NetSetupUnjoined
 コンピューターが参加していません。
NetSetupWorkgroupName
 コンピューターはワークグループに参加しています。
NetSetupDomainName
 コンピューターはドメインに参加しています。

戻り値

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

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

リターン コード 説明
ERROR_NOT_ENOUGH_MEMORY
 このコマンドを処理するのに十分なストレージがありません。

解説

NetGetJoinInformation 関数を正常に実行するために、特別なグループ メンバーシップは必要ありません。

要件

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

関連項目

NetGetJoinableOUs

ネットワーク管理機能

ネットワーク管理の概要