Funzione SetNtmsObjectSecurity (ntmsapi.h)

Articolo
03/08/2023

[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]

La funzione SetNtmsObjectSecurity scrive il descrittore di sicurezza per l'oggetto RSM specificato.

Sintassi

DWORD SetNtmsObjectSecurity(
  [in] HANDLE               hSession,
  [in] LPNTMS_GUID          lpObjectId,
  [in] DWORD                dwType,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR lpSecurityDescriptor
);

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpObjectId

Identificatore univoco dell'oggetto RSM.

[in] dwType

Tipo di oggetto RSM. Per un elenco dei tipi di oggetto, vedere NtmsObjectsTypes.

[in] SecurityInformation

Valore SECURITY_INFORMATION che specifica le informazioni di sicurezza da scrivere nell'oggetto RSM.

[in] lpSecurityDescriptor

Puntatore a una struttura di SECURITY_DESCRIPTOR che specifica il descrittore di sicurezza da scrivere nell'oggetto RSM: NTMS_USE_ACCESS, NTMS_CONTROL_ACCESS o NTMS_MODIFY_ACCESS.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	I privilegi necessari per modificare il descrittore di sicurezza vengono negati.
ERROR_DATABASE_FAILURE	Il database non è accessibile o danneggiato.
ERROR_DATABASE_FULL	Il database è pieno.
ERROR_INVALID_HANDLE	L'handle di sessione è mancante o non è valido.
ERROR_INVALID_PARAMETER	ID oggetto mancante.
ERROR_NO_SECURITY_ON_OBJECT	Non sono presenti informazioni di sicurezza per questo oggetto.
ERROR_OBJECT_NOT_FOUND	L'ID oggetto non è valido.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

Se un'applicazione usa SetNtmsObjectSecurity per impostare l'elenco di controllo di accesso discrezionale (ACL) di un oggetto, l'applicazione deve disporre dell'autorizzazione WRITE_DAC o essere il proprietario dell'oggetto.

Se un'applicazione usa SetNtmsObjectSecurity per impostare l'ACL di sistema di un oggetto, è necessario abilitare il privilegio SE_SECURITY_NAME per l'applicazione. Per altre informazioni, vedere la funzione SetPrivateObjectSecurity . Per altre informazioni sulla sicurezza RSM, vedere Sicurezza RSM.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntmsapi.h
Libreria	Ntmsapi.lib
DLL	Ntmsapi.dll

Vedi anche

EnumerateNtmsObject

GetNtmsObjectSecurity

Funzioni di gestione oggetti

Condividi tramite