NetGetDisplayInformationIndex 関数 (lmaccess.h)

NetGetDisplayInformationIndex 関数は、名前が指定された文字列で始まるか、名前が文字列のアルファベット順に続く最初の表示情報エントリのインデックスを返します。 この関数を使用して、 NetQueryDisplayInformation 関数の後続の呼び出しの開始インデックスを決定できます。

構文

NET_API_STATUS NET_API_FUNCTION NetGetDisplayInformationIndex(
  [in]  LPCWSTR ServerName,
  [in]  DWORD   Level,
  [in]  LPCWSTR Prefix,
  [out] LPDWORD Index
);

パラメーター

[in] ServerName

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

[in] Level

クエリを実行するアカウントのレベルを指定します。 このパラメーターには、次の値のいずれかを指定できます。

説明
1
すべてのローカル およびグローバル (通常) ユーザー アカウントに対してクエリを実行します。
2
すべてのワークステーションおよびサーバー ユーザー アカウントに対してクエリを実行します。
3
すべてのグローバル グループに対してクエリを実行します。

[in] Prefix

検索するプレフィックスを指定する文字列へのポインター。

[out] Index

要求されたエントリのインデックスを受け取る値へのポインター。

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
ユーザーには、要求された情報へのアクセス権がありません。
ERROR_INVALID_LEVEL
Level パラメーターに指定された値が無効です。
ERROR_NO_MORE_ITEMS
操作する項目はこれ以上ありませんでした。
NERR_InvalidComputer
コンピューター名が無効です。

解説

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

関数は、呼び出し元が読み取りアクセス権を持つ情報のみを返します。 呼び出し元は、Domain オブジェクトへのリスト コンテンツ アクセス権と、システム コンテナーにある SAM サーバー オブジェクトに対する SAM ドメイン全体のアクセス権を列挙する必要があります。

要件

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

関連項目

関数を取得する

NetQueryDisplayInformation

ネットワーク管理機能

ネットワーク管理の概要