ホーム › NetworkManagement.WNet › PF_NPGetDirectoryType

PF_NPGetDirectoryType

コールバック

シグネチャ

DWORD PF_NPGetDirectoryType(
    LPWSTR lpName,
    INT* lpType,
    BOOL bFlushCache
);

パラメーター

フィールド	型	説明
lpName	LPWSTR	ディレクトリの完全修飾名へのポインターです。ネットワークプロバイダーは、lpType が指すアドレスに種類を返します。lpType に返された値が 0 の場合、またはネットワークプロバイダーがエラーを返した場合、ファイルマネージャーはそのディレクトリを「通常の」ディレクトリとして表示します。
lpType	INT*	ネットワークプロバイダーが定義する値へのポインターです。この値は、ファイルマネージャーにおけるドライブツリーの表示を変更するために使用されます。これにより、ネットワークプロバイダーは特別なディレクトリをユーザーに示すことができます。
bFlushCache	BOOL	Refresh によるウィンドウの再描画時に、ファイルマネージャーが MPR を呼び出してディレクトリの種類を最初に取得するときは TRUE に設定されます。それ以降は FALSE になります。これにより、プロバイダーは、ドライブのデータを一度だけ読み取って次の Refresh までキャッシュするといったパフォーマンスの最適化を行う機会が得られます。

公式ドキュメント

ネットワークディレクトリの種類を判別します。NPGetDirectoryType 関数はファイルマネージャーによって使用されます。

戻り値

この関数は、成功した場合は WN_SUCCESS を返します。失敗した場合はエラーコードを返します。エラーコードには次のものが含まれます。

戻り値	説明
WN_NOT_SUPPORTED	NPGetDirectoryType はサポートされていません。

解説(Remarks)

ファイルマネージャーは、すべての特別なネットワークディレクトリに対して独自のアイコンを用意します。つまり、lpType が 0 以外の値に設定されている場合、ファイルマネージャーは特別なフォルダーアイコンを表示します。

この関数の呼び出しはファイルマネージャーがディレクトリツリーを描画している最中に発生するため、その実装は高性能、すなわち高速である必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)