NetFileGetInfo 関数 (lmshare.h)

  • [アーティクル]

サーバー リソースの特定のオープンに関する情報を取得します。

構文

NET_API_STATUS NET_API_FUNCTION NetFileGetInfo(
  [in]  LMSTR  servername,
  [in]  DWORD  fileid,
  [in]  DWORD  level,
  [out] LPBYTE *bufptr
);

パラメーター

[in] servername

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

_WIN32_WINNTまたはFORCE_UNICODEが定義されている場合、この文字列は Unicode です。

[in] fileid

情報を返す開いているリソースのファイル識別子を指定します。 このパラメーターの値は、前の列挙呼び出しで返されている必要があります。 詳細については、「解説」を参照してください。

[in] level

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

値 説明
2
 ファイル識別番号を返します。 bufptr パラメーターは、FILE_INFO_2構造体へのポインターです。
3
 ファイル識別番号と、ファイルに関するその他の情報を返します。 bufptr パラメーターは、FILE_INFO_3構造体へのポインターです。

[out] bufptr

情報を受信するバッファーのアドレスへのポインター。 このデータの形式は、 level パラメーターの値によって異なります。 このバッファーはシステムによって割り当てられ、 NetApiBufferFree 関数を使用して解放する必要があります。 詳細については、「 ネットワーク管理機能バッファー 」および「 ネットワーク管理機能バッファーの長さ」を参照してください。

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
 ユーザーには、要求された情報へのアクセス権がありません。
ERROR_FILE_NOT_FOUND
 ファイルが見つかりませんでした。
ERROR_INVALID_LEVEL
 level パラメーターに指定された値が無効です。
ERROR_NOT_ENOUGH_MEMORY
 メモリ不足です。
NERR_BufTooSmall
 指定されたバッファーが小さすぎます。

解説

NetFileGetInfo 関数を正常に実行できるのは、Administrators または Server Operators ローカル グループのメンバーだけです。

NetFileEnum 関数を呼び出して、サーバー上で開いている複数のファイルに関する情報を取得できます。

Active Directory のプログラミングを行っている場合は、特定の Active Directory サービス インターフェイス (ADSI) メソッドを呼び出して、 NetFileGetInfo を呼び出すことで実現できるのと同じ機能を実現できる場合があります。 詳細については、「 IADsResource 」と「 IADsFileServiceOperations」を参照してください。

要件

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

関連項目

FILE_INFO_2

FILE_INFO_3

NetFile 関数

NetFileEnum

ネットワーク管理機能

ネットワーク管理の概要