IoSetShareAccessEx 関数 (wdm.h)
IoSetShareAccessEx ルーチンは、指定されたファイル オブジェクトを共有するためのアクセス権を設定します。
構文
void IoSetShareAccessEx(
[in] ACCESS_MASK DesiredAccess,
[in] ULONG DesiredShareAccess,
[in, out] PFILE_OBJECT FileObject,
[out] PSHARE_ACCESS ShareAccess,
[in, optional] PBOOLEAN WritePermission
);
パラメーター
[in] DesiredAccess
ファイル オブジェクトに対 して要求されるアクセスの種類を表すACCESS_MASK値を指定します。 システム定義の DesiredAccess フラグの完全な一覧については、「IoCreateFile」を参照してください。
[in] DesiredShareAccess
ファイル オブジェクトに設定する共有アクセスの種類を指定します。 この値には、0 または次のフラグの任意の組み合わせを指定できます。
FILE_SHARE_READ
FILE_SHARE_WRITE
FILE_SHARE_DELETE
[in, out] FileObject
共有アクセスが設定またはリセットされているファイル オブジェクトへのポインター。
[out] ShareAccess
FileObject に関連付けられているSHARE_ACCESS構造体へのポインター。 ドライバーは、この構造体を不透明として扱う必要があります。
[in, optional] WritePermission
ファイル オブジェクトに書き込みアクセス許可があるかどうかを指定する値へのポインター。 共有に書き込みアクセス許可がある場合、この値は TRUE です。それ以外の場合は FALSE です。 値が FALSE で、呼び出し元が排他的読み取りアクセス権を取得しようとすると、書き込みアクセス許可はFILE_SHARE_READにダウングレードされます。
戻り値
なし
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h |
| Library | Ntoskrnl.lib |