Share via

DSCreateSecurityPage 함수(dssec.h)

  • 아티클

DSCreateSecurityPage 함수는 Active Directory 개체에 대한 보안 속성 페이지를 만듭니다. 결과 속성 페이지를 속성 시트에 추가할 수 있습니다.

구문

HRESULT DSCreateSecurityPage(
  [in]           LPCWSTR                pwszObjectPath,
  [in, optional] LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          HPROPSHEETPAGE         *phPage,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

매개 변수

[in] pwszObjectPath

개체의 전체 Active Directory 경로를 나타내는 null로 끝나는 와이드 문자열에 대한 포인터입니다.

[in, optional] pwszObjectClass

개체 클래스를 나타내는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.

[in] dwFlags

보안 속성 페이지에 사용되는 플래그입니다. 이 매개 변수는 없음 또는 다음 플래그의 조합일 수 있습니다.

값 의미
DSSI_READ_ONLY
0x00000001
 보안 속성은 읽기 전용입니다.
DSSI_NO_ACCESS_CHECK
0x00000002
 액세스 검사 수행되지 않습니다.
DSSI_NO_EDIT_SACL
0x00000004
 SACL( 시스템 액세스 제어 목록 ) 속성은 읽기 전용입니다.
DSSI_NO_EDIT_OWNER
0x00000008
 개체 소유자 속성은 읽기 전용입니다.
DSSI_IS_ROOT
0x00000010
 개체가 루트 개체입니다.
DSSI_NO_FILTER
0x00000020
 필터를 적용하지 마세요.
DSSI_NO_READONLY_MESSAGE
0x00000040
 읽기 전용 팝업 메시지를 표시하지 않습니다.

[out] phPage

생성된 보안 속성 페이지를 반환하는 HPROPSHEETPAGE 에 대한 포인터입니다.

[in, optional] pfnReadSD

개체의 보안 설명자를 읽는 데 사용되는 함수에 대한 포인터입니다. 이 값은 NULL일 수 있습니다. pfnReadSD가 NULL이 아닌 경우 DSCreateSecurityPage는 pfnReadSD에서 참조하는 함수를 호출하여 개체의 보안 설명자를 검색합니다.

[in, optional] pfnWriteSD

개체의 보안 설명자를 작성하는 데 사용되는 함수에 대한 포인터입니다. 이 값은 NULL일 수 있습니다. pfnWriteSD가 NULL이 아닌 경우 DSCreateSecurityPage는 pfnWriteSD에서 참조하는 함수를 호출하여 개체의 보안 설명자를 작성합니다.

[in] lpContext

pfnReadSD 또는 pfnWriteSD로 식별되는 함수에 전달할 컨텍스트입니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

설명

pfnReadSD에서 가리키는 함수는 다음과 같이 정의됩니다.

#include <windows.h>

typedef HRESULT (WINAPI *PFNREADOBJECTSECURITY)(
    LPCWSTR,               // Active Directory path of object
    SECURITY_INFORMATION,  // the security information to read
    PSECURITY_DESCRIPTOR*, // the returned security descriptor 
    LPARAM                 // context parameter
);

DSCreateSecurityPage 함수는 LocalFree 함수를 호출하여 위의 세 번째 매개 변수에 반환된 보안 설명자를 해제합니다.

pfnWriteSD에서 가리키는 함수는 다음과 같이 정의됩니다.

#include <windows.h>

typedef HRESULT (WINAPI *PFNWRITEOBJECTSECURITY)(
    LPCWSTR,              // Active Directory path of object
    SECURITY_INFORMATION, // the security information to write
    PSECURITY_DESCRIPTOR, // the security descriptor to write
    LPARAM                // context parameter
);

요구 사항

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

추가 정보

기본 보안 속성 페이지

ISecurityInformation