CreateNtmsMediaPoolA 함수(ntmsapi.h)
[Windows 7 및 Windows Server 2008 R2를 기준으로 이동식 스토리지 관리자 를 더 이상 사용할 수 없습니다.]
CreateNtmsMediaPool 함수는 새 애플리케이션 미디어 풀을 만듭니다.
구문
DWORD CreateNtmsMediaPoolA(
[in] HANDLE hSession,
[in] LPCSTR lpPoolName,
[in] LPNTMS_GUID lpMediaType,
[in] DWORD dwAction,
[in] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
[out] LPNTMS_GUID lpPoolId
);
매개 변수
[in] hSession
OpenNtmsSession 함수에서 반환된 세션에 대한 핸들입니다.
[in] lpPoolName
새 미디어 풀의 이름입니다. 미디어 풀 이름은 단일 RSM 데이터베이스의 scope 내에서 고유해야 합니다.
[in] lpMediaType
이 미디어 풀의 미디어 유형에 대한 식별자입니다. EnumerateNtmsObject 함수를 사용하여 사용 가능한 미디어 형식 및 해당 특성 목록을 가져옵니다. 애플리케이션은 NULL 포인터를 전달하여 다른 미디어 풀만 포함하는 미디어 풀을 만들 수 있습니다.
[in] dwAction
수행할 작업입니다. 이 매개 변수는 다음 값 중 하나여야 합니다.
| 값 | 의미 |
|---|---|
|
이름으로 기존 미디어 풀을 엽니다. 풀이 없으면 ERROR_OBJECT_NOT_FOUND 반환합니다. |
|
기존 미디어 풀을 열거나 풀이 없는 경우 풀을 만듭니다. |
|
새 미디어 풀을 만듭니다. 풀이 있는 경우 ERROR_ALREADY_EXISTS 반환합니다. |
[in] lpSecurityAttributes
풀에 대한 액세스를 제한하는 데 사용되는 선택적 보안 설명자입니다.
[out] lpPoolId
미디어 풀을 성공적으로 만들거나 연 후 미디어 풀의 고유 식별자를 받는 변수에 대한 포인터입니다.
반환 값
이 함수는 다음 값 중 하나를 반환합니다.
| 값 | 의미 |
|---|---|
|
새 미디어 풀을 만드는 동안 루트 풀 또는 부모 미디어 풀에 대한 NTMS_CONTROL_ACCESS 거부됩니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다.
Windows XP: 새 미디어 풀을 만드는 동안 부모 미디어 풀에 대한 NTMS_MODIFY_ACCESS 거부됩니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다. |
|
이 이름의 미디어 풀이 이미 있으므로 새 미디어 풀을 만들 수 없습니다. |
|
데이터베이스에 액세스할 수 없거나 손상되었습니다. |
|
데이터베이스가 가득 찼습니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다. |
|
세션 핸들이 없거나 잘못되었습니다. |
|
선택한 미디어 유형이 잘못되었습니다. |
|
풀 이름 구문이 잘못되었습니다. (이름이 너무 깁니다.) |
|
미디어 풀 이름 또는 미디어 풀 ID 포인터가 없습니다. |
|
기존 미디어 풀을 열 수 없습니다. |
|
함수가 성공했습니다. |
설명
무료, 인식할 수 없음 및 가져오기 미디어 풀은 RSM에서 생성되며 CreateNtmsMediaPool 함수를 사용하여 만들 수 없습니다.
RSM 미디어 풀은 "" 문자로 구분된 계층 구조로 구성됩니다. 애플리케이션, 무료, 인식할 수 없음 및 가져오기 미디어 풀은 계층 구조의 루트에 있습니다. RSM은 무료, 인식할 수 없음 및 가져오기 풀을 만들고 관리합니다. RSM은 사용 가능한 각 미디어 유형에 대한 무료 미디어 풀을 만듭니다.
애플리케이션별 미디어 풀은 애플리케이션에서 만듭니다. 애플리케이션은 루트 애플리케이션 풀에서 자체 사용하기 위해 미디어 풀을 만듭니다. 이러한 미디어 풀에는 파일 시스템과 유사한 이름이 있습니다. 이름의 끝점만 미디어 및 정책을 포함합니다. 애플리케이션은 \MyApp\Pool1 및 \MyApp\Pool2와 같은 풀을 정의할 수 있습니다. 이렇게 하면 계층 구조가 사용자 인터페이스로 전달되고 이름이 중복되는 것을 방지할 수 있습니다. 각 풀 수준은 개별적으로 만들어야 합니다. 폴더 및 파일과 마찬가지로 먼저 MyApp 및 Pool1 및 Pool2를 선택합니다.
Windows Server 2003: 미디어 풀을 만들려면 루트 풀 및 부모 풀에 대한 NTMS_CONTROL_ACCESS 있어야 합니다. 보안 설명자가 제공되지 않으면 풀은 부모 풀의 ACE를 상속합니다(부모 풀이 루트 풀이 아닌 경우). 또한 작성자 및 로컬 시스템 계정은 풀에 대한 모든 권한을 갖습니다. 부모 풀이 루트 풀인 경우 해당 ACL은 상속되지 않습니다. DACL의 유일한 ACE는 작성자 및 로컬 시스템 계정에 대한 모든 액세스 권한입니다.
참고
ntmsapi.h 헤더는 CREATENtmsMediaPool을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ntmsapi.h |
| 라이브러리 | Ntmsapi.lib |
| DLL | Ntmsapi.dll |