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 systemdefinierter 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 Schreibberechtigungen besitzt. Dieser Wert ist TRUE, wenn die Freigabe schreibberechtigungen hat; andernfalls ist es FALSE. Wenn der Wert FALSE- ist und der Aufrufer versucht, exklusiven Lesezugriff zu übernehmen, wird die Schreibberechtigung auf FILE_SHARE_READ herabgestuft.
Rückgabewert
Nichts
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | wdm.h |
| Library | Ntoskrnl.lib |