Funzione GetNtmsObjectSecurity (ntmsapi.h)

Articolo
02/29/2024

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

La funzione GetNtmsObjectSecurity legge il descrittore di sicurezza per l'oggetto RSM specificato.

Sintassi

DWORD GetNtmsObjectSecurity(
  [in]  HANDLE               hSession,
  [in]  LPNTMS_GUID          lpObjectId,
  [in]  DWORD                dwType,
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR lpSecurityDescriptor,
  [in]  DWORD                nLength,
  [out] LPDWORD              lpnLengthNeeded
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpObjectId

Identificatore univoco dell'oggetto RSM.

[in] dwType

Tipo di oggetto. Per un elenco di tipi di oggetti, vedere NtmsObjectsTypes.

[in] RequestedInformation

Valore SECURITY_INFORMATION che specifica i dati di sicurezza richiesti.

[out] lpSecurityDescriptor

Puntatore a una struttura SECURITY_DESCRIPTOR che riceve il descrittore di sicurezza.

[in] nLength

Lunghezza del descrittore.

[out] lpnLengthNeeded

Lunghezza necessaria del buffer se non è sufficiente per il descrittore di sicurezza, in byte.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	READ_CONTROL negato l'accesso all'oggetto. Windows XP: Non sono necessari diritti di accesso.
ERROR_DATABASE_FAILURE	Il database è inaccessibile o danneggiato.
ERROR_INVALID_HANDLE	L'handle di sessione non è valido o non è valido.
ERROR_INVALID_PARAMETER	Id oggetto mancante.
ERROR_NO_SECURITY_ON_OBJECT	Non sono disponibili informazioni di sicurezza per questo oggetto.
ERROR_OBJECT_NOT_FOUND	L'ID oggetto non è valido.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

La sicurezza RSM usa i descrittori di sicurezza standard e i membri delle informazioni. In questo modo, le finestre di dialogo di sicurezza standard possono essere usate per selezionare la sicurezza RSM. Per altre informazioni, vedere la funzione SetPrivateObjectSecurity . Per altre informazioni sulla sicurezza RSM, vedere Sicurezza RSM.

Requisiti

Requisito	Valore
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

Funzioni di gestione oggetti

SetNtmsObjectSecurity

Condividi tramite