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

Siehe auch

ACCESS_MASK

IoCreateFile-