IoSetShareAccessEx-Funktion (wdm.h)
Die IoSetShareAccessEx-Routine legt die Zugriffsrechte für die Freigabe des angegebenen Dateiobjekts fest.
Syntax
void IoSetShareAccessEx(
[in] ACCESS_MASK DesiredAccess,
[in] ULONG DesiredShareAccess,
[in, out] PFILE_OBJECT FileObject,
[out] PSHARE_ACCESS ShareAccess,
[in, optional] PBOOLEAN WritePermission
);
Parameter
[in] DesiredAccess
Gibt einen ACCESS_MASK Wert an, der den Typ des Zugriffs darstellt, der für das Dateiobjekt angefordert wird. Eine vollständige Liste der systemdefinierten DesiredAccess-Flags finden Sie unter IoCreateFile.
[in] DesiredShareAccess
Gibt den Typ des Freigabezugriffs an, der für das Dateiobjekt festgelegt werden soll. Dieser Wert kann null oder eine beliebige Kombination der folgenden Flags sein:
FILE_SHARE_READ
FILE_SHARE_WRITE
FILE_SHARE_DELETE
[in, out] FileObject
Ein Zeiger auf das Dateiobjekt, dessen Freigabezugriff festgelegt oder zurückgesetzt wird.
[out] ShareAccess
Ein Zeiger auf die SHARE_ACCESS Struktur, die FileObject zugeordnet ist. Treiber sollten diese Struktur als undurchsichtig behandeln.
[in, optional] WritePermission
Ein Zeiger auf den Wert, der angibt, ob das Dateiobjekt über Schreibberechtigungen verfügt. Dieser Wert ist TRUE , wenn die Freigabe über Schreibberechtigungen verfügt. Andernfalls ist es FALSE. Wenn der Wert FALSE ist und der Aufrufer versucht, exklusiven Lesezugriff zu erhalten, wird die Schreibberechtigung auf FILE_SHARE_READ herabgestuft.
Rückgabewert
Keine
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Zielplattform | Universell |
| Header | wdm.h |
| Bibliothek | Ntoskrnl.lib |