指定した UNC パスがオフライン ファイル キャッシュ内にあるかどうかを判断します。
構文
HRESULT IsPathCacheable(
[in] LPCWSTR pszPath,
[out] BOOL *pbCacheable,
[out] OFFLINEFILES_CACHING_MODE *pShareCachingMode
);
パラメーター
[in] pszPath
アイテムの UNC パス。
[out] pbCacheable
アイテムがオフライン ファイル キャッシュ内にある場合は TRUE 、そうでない場合は FALSE を 受け取ります。
[out] pShareCachingMode
指定した項目が存在する該当するネットワーク共有フォルダーのキャッシュ構成を示す、次の OFFLINEFILES_CACHING_MODE 列挙値のいずれかを受け取ります。
OFFLINEFILES_CACHING_MODE_NONE (0)
キャッシュ モードの値が見つかりませんでした。 この値は、アイテムがキャッシュできない場合、またはエラーが発生した場合に使用されます。
OFFLINEFILES_CACHING_MODE_NOCACHING (1)
共有フォルダーは、キャッシュを禁止するように構成されています。
OFFLINEFILES_CACHING_MODE_MANUAL (2)
共有フォルダーは、手動キャッシュを許可するように構成されています。
OFFLINEFILES_CACHING_MODE_AUTO_DOC (3)
共有フォルダーは、ドキュメントの自動キャッシュを許可するように構成されています。
OFFLINEFILES_CACHING_MODE_AUTO_PROGANDDOC (4)
共有フォルダーは、プログラムとドキュメントの自動キャッシュを許可するように構成されています。
戻り値
成功 した場合はS_OK 、それ以外の場合はエラー値を返します。
注釈
返されるキャッシュ モードの値は、NetShareGetInfo によって返されるSHARE_INFO_1005に関連付けられているCSC_MASK値と同じです。 値マッピングは次のとおりです。
| OFFLINEFILES_CACHING_MODE 値 | SHARE_INFO_1005 値 |
|---|---|
| OFFLINEFILES_CACHING_MODE_NOCACHING | 0 |
| OFFLINEFILES_CACHING_MODE_MANUAL | CSC_CACHE_MANUAL_REINT |
| OFFLINEFILES_CACHING_MODE_AUTO_DOC | CSC_CACHE_AUTO_REINT |
| OFFLINEFILES_CACHING_MODE_AUTO_PROGANDDOC | CSC_CACHE_VDO |
これらの設定は、共有フォルダーの [共有] プロパティ ページの [キャッシュ] ボタンをクリックするか、 コマンドを使用 net share /cache して、サーバー上の共有フォルダーの属性として構成されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | cscobj.h |
| [DLL] | CscSvc.dll;CscObj.dll |