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 구조체에 대한 포인터입니다.
반환 값
이 함수는 다음 값 중 하나를 반환합니다.
값 | 의미 |
---|---|
|
보안 설명자를 수정하는 데 필요한 권한은 거부됩니다. |
|
데이터베이스에 액세스할 수 없거나 손상되었습니다. |
|
데이터베이스가 가득 찼습니다. |
|
세션 핸들이 없거나 잘못되었습니다. |
|
개체 ID가 없습니다. |
|
이 개체에 대한 보안 정보가 없습니다. |
|
개체 ID가 잘못되었습니다. |
|
함수가 성공했습니다. |
설명
애플리케이션이 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 |