NetAccessEnum 関数 (lmaccess.h)

[この関数は廃止されました。 代替関数の一覧については、「 Authorization Functions」を参照してください。

サポートされていません。

NetAccessEnum 関数は、各アクセス許可レコードに関する情報を取得します。

構文

NET_API_STATUS NET_API_FUNCTION NetAccessEnum(
  LPCWSTR servername,
  LPCWSTR BasePath,
  DWORD   Recursive,
  DWORD   level,
  LPBYTE  *bufptr,
  DWORD   prefmaxlen,
  LPDWORD entriesread,
  LPDWORD totalentries,
  LPDWORD resume_handle
);

パラメーター

servername

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

BasePath

リソースのベース パス名を含む文字列へのポインター。 NULL ポインターまたは NULL 文字列は、基本パスが使用されていないことを意味します。 パスは、汎用名前付け規則 (UNC) パス名として指定できます。

Recursive

再帰的検索を有効または無効にするフラグを指定します。

このパラメーターが 0 に等しい場合、 NetAccessEnum 関数は pszBasePath パラメーターによってベース パスとしてという名前のリソースと、そのベース パスのすぐ下にあるリソースのエントリを返します。

このパラメーターが 0 以外の場合、関数は、リソース名の先頭に pszBasePath を持つすべてのアクセス制御リスト (ACL) のエントリを返します。

level

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

値	意味
0	pbBuffer パラメーターは、access_info_0構造体を指します。
1	pbBuffer パラメーターは、access_info_1構造体を指します。

bufptr

アクセス情報構造体を受け取るバッファーへのポインター。 このデータの形式は、 sLevel パラメーターの値によって異なります。

prefmaxlen

pbBuffer パラメーターが指すバッファーのサイズをバイト単位で指定します。

entriesread

実際に列挙された要素の数を受け取る符号なし短整数へのポインター。 カウントは、 NetAccessEnum 関数が NERR_Success または ERROR_MORE_DATAを返す場合にのみ有効です。

totalentries

列挙された可能性のあるエントリの合計数を受け取る符号なし短整数へのポインター。 カウントは、 NetAccessEnum 関数が NERR_Success または ERROR_MORE_DATAを返す場合にのみ有効です。

resume_handle

TBD

戻り値

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

関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの一覧については、「 システム エラー コード」を参照してください。

注釈

この関数では、ローカル セキュリティが有効になっているコンピューターで正常に実行するには、管理特権が必要です。

要件

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

こちらもご覧ください

承認関数