NetGroupGetInfo 関数 (lmaccess.h)

[アーティクル]
08/24/2023

NetGroupGetInfo 関数は、セキュリティデータベース内の特定のグローバルグループ (セキュリティアカウントマネージャー (SAM) データベース)、またはドメインコントローラーの場合は Active Directory に関する情報を取得します。

構文

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

パラメーター

[in] servername

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

[in] groupname

情報を取得するグローバルグループの名前を指定する定数文字列へのポインター。詳細については、「解説」を参照してください。

[in] level

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

値	意味
0	グローバルグループ名を返します。 bufptr パラメーターは、GROUP_INFO_0構造体を指します。
1	グローバルグループ名とコメントを返します。 bufptr パラメーターは、GROUP_INFO_1構造体を指します。
2	グローバルグループに関する詳細情報を返します。 bufptr パラメーターは、GROUP_INFO_2構造体を指します。 Windows XP 以降では、代わりに GROUP_INFO_3 を使用することをお勧めします。
3	グローバルグループに関する詳細情報を返します。 bufptr パラメーターは、GROUP_INFO_3構造体を指します。 Windows 2000: このレベルはサポートされていません。

[out] bufptr

グローバルグループ情報構造体を受け取るバッファーのアドレスへのポインター。このデータの形式は 、level パラメーターの値によって異なります。システムは、このバッファーにメモリを割り当てます。メモリの割り当てを解除するには、 NetApiBufferFree 関数を呼び出す必要があります。詳細については、「ネットワーク管理機能バッファー」および「ネットワーク管理機能バッファーの長さ」を参照してください。

戻り値

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

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

リターンコード	説明
ERROR_ACCESS_DENIED	ユーザーには、要求された情報へのアクセス権がありません。
NERR_InvalidComputer	コンピューター名が無効です。
NERR_GroupNotFound	グローバルグループ名が見つかりませんでした。

注釈

Active Directory をプログラミングしている場合は、特定の Active Directory サービスインターフェイス (ADSI) メソッドを呼び出して、ネットワーク管理グループ関数を呼び出すことで実現できるのと同じ機能を実現できます。詳細については、「 IADsGroup」を参照してください。

Active Directory を実行しているドメインコントローラーでこの関数を呼び出すと、セキュリティ保護可能なオブジェクトのアクセス制御リスト (ACL) に基づいてアクセスが許可または拒否されます。既定の ACL では、"Pre-Windows 2000 互換アクセス" グループのすべての認証済みユーザーとメンバーに情報の表示が許可されます。メンバーサーバーまたはワークステーションでこの関数を呼び出すと、すべての認証済みユーザーが情報を表示できます。これらのプラットフォームでの匿名アクセスと匿名アクセスの制限については、「ネットワーク管理機能のセキュリティ要件」を参照してください。 ACL、ACE、およびアクセストークンの詳細については、「Access Control モデル」を参照してください。

Group オブジェクトのセキュリティ記述子は、この関数のアクセスチェックを実行するために使用されます。

ユーザーアカウント名は 20 文字に制限され、グループ名は 256 文字に制限されます。さらに、アカウント名をピリオドで終えることはできません。また、コンマまたは印刷可能な文字を含めることはできません: "、/、、[、]、:、|、 <、 >、+、=、;、;、?、*。また、名前には、印刷できない 1 から 31 の範囲の文字を含めることはできません。

要件

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