SetNtmsObjectSecurity 함수(ntmsapi.h)

[Windows 7 및 Windows Server 2008 R2를 기준으로 이동식 스토리지 관리자 를 더 이상 사용할 수 없습니다.]

SetNtmsObjectSecurity 함수는 지정된 RSM 개체에 대한 보안 설명자를 씁니다.

구문

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

매개 변수

[in] hSession

OpenNtmsSession 함수에서 반환된 세션에 대한 핸들입니다.

[in] lpObjectId

RSM 개체의 고유 식별자입니다.

[in] dwType

RSM 개체 형식입니다. 개체 형식 목록은 NtmsObjectsTypes를 참조하세요.

[in] SecurityInformation

RSM 개체에 쓸 보안 정보를 지정하는 SECURITY_INFORMATION 값입니다.

[in] lpSecurityDescriptor

RSM 개체에 쓸 보안 설명자( NTMS_USE_ACCESS , NTMS_CONTROL_ACCESS 또는 NTMS_MODIFY_ACCESS)를 지정하는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다.

반환 값

이 함수는 다음 값 중 하나를 반환합니다.

값	의미
ERROR_ACCESS_DENIED	보안 설명자를 수정하는 데 필요한 권한은 거부됩니다.
ERROR_DATABASE_FAILURE	데이터베이스에 액세스할 수 없거나 손상되었습니다.
ERROR_DATABASE_FULL	데이터베이스가 가득 찼습니다.
ERROR_INVALID_HANDLE	세션 핸들이 없거나 잘못되었습니다.
ERROR_INVALID_PARAMETER	개체 ID가 없습니다.
ERROR_NO_SECURITY_ON_OBJECT	이 개체에 대한 보안 정보가 없습니다.
ERROR_OBJECT_NOT_FOUND	개체 ID가 잘못되었습니다.
ERROR_SUCCESS	함수가 성공했습니다.

설명

애플리케이션이 SetNtmsObjectSecurity 를 사용하여 개체의 임의 ACL(액세스 제어 목록)을 설정하는 경우 애플리케이션에는 WRITE_DAC 권한이 있거나 개체의 소유자여야 합니다.

애플리케이션이 SetNtmsObjectSecurity 를 사용하여 개체의 시스템 ACL을 설정하는 경우 애플리케이션에 대해 SE_SECURITY_NAME 권한을 사용하도록 설정해야 합니다. 자세한 내용은 SetPrivateObjectSecurity 함수를 참조하세요. RSM 보안에 대한 자세한 내용은 RSM 보안을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	ntmsapi.h
라이브러리	Ntmsapi.lib
DLL	Ntmsapi.dll

추가 정보

EnumerateNtmsObject

GetNtmsObjectSecurity

개체 관리 함수