다음을 통해 공유

GetNtmsObjectSecurity 함수(ntmsapi.h)

  • 아티클

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

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

구문

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
);

매개 변수

[in] hSession

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

[in] lpObjectId

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

[in] dwType

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

[in] RequestedInformation

요청된 보안 데이터를 지정하는 SECURITY_INFORMATION 값입니다.

[out] lpSecurityDescriptor

보안 설명자를 수신하는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다.

[in] nLength

설명자의 길이입니다.

[out] lpnLengthNeeded

보안 설명자에 대해 충분히 크지 않은 경우 버퍼의 필수 길이(바이트)입니다.

반환 값

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

값 의미
ERROR_ACCESS_DENIED
 개체에 대한 READ_CONTROL 액세스가 거부되었습니다.

Windows XP: 액세스 권한이 필요하지 않습니다.
ERROR_DATABASE_FAILURE
 데이터베이스에 액세스할 수 없거나 손상되었습니다.
ERROR_INVALID_HANDLE
 세션 핸들이 없거나 잘못되었습니다.
ERROR_INVALID_PARAMETER
 개체 ID가 없습니다.
ERROR_NO_SECURITY_ON_OBJECT
 이 개체에 대한 보안 정보가 없습니다.
ERROR_OBJECT_NOT_FOUND
 개체 ID가 잘못되었습니다.
ERROR_SUCCESS
 함수가 성공했습니다.

설명

RSM 보안은 표준 보안 설명자 및 정보 멤버를 사용합니다. 이렇게 하면 표준 보안 대화 상자를 사용하여 RSM 보안을 선택할 수 있습니다. 자세한 내용은 SetPrivateObjectSecurity 함수를 참조하세요. RSM 보안에 대한 자세한 내용은 RSM 보안을 참조하세요.

요구 사항

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

추가 정보

EnumerateNtmsObject

개체 관리 함수

SetNtmsObjectSecurity