GROUP_POLICY_OBJECTW 구조체(userenv.h)

아티클
11/20/2024

GROUP_POLICY_OBJECT 구조체는 GPO 목록의 GPO에 대한 정보를 제공합니다.

통사론

typedef struct _GROUP_POLICY_OBJECTW {
  DWORD                        dwOptions;
  DWORD                        dwVersion;
  LPWSTR                       lpDSPath;
  LPWSTR                       lpFileSysPath;
  LPWSTR                       lpDisplayName;
  WCHAR                        szGPOName[50];
  GPO_LINK                     GPOLink;
  LPARAM                       lParam;
  struct _GROUP_POLICY_OBJECTW *pNext;
  struct _GROUP_POLICY_OBJECTW *pPrev;
  LPWSTR                       lpExtensions;
  LPARAM                       lParam2;
  LPWSTR                       lpLink;
} GROUP_POLICY_OBJECTW, *PGROUP_POLICY_OBJECTW;

회원

dwOptions

링크 옵션을 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

GPO_FLAG_DISABLE

이 GPO를 사용할 수 없습니다.

GPO_FLAG_FORCE

이 GPO의 정책 설정을 후속 GPO의 정책 설정으로 재정의하지 마세요.

dwVersion

GPO의 버전 번호를 지정합니다.

lpDSPath

GPO의 디렉터리 서비스 부분에 대한 경로를 지정하는 문자열에 대한 포인터입니다.

lpFileSysPath

GPO의 파일 시스템 부분에 대한 경로를 지정하는 문자열에 대한 포인터입니다.

lpDisplayName

GPO의 표시 이름에 대한 포인터입니다.

szGPOName[50]

GPO를 식별하는 고유한 이름을 지정하는 문자열에 대한 포인터입니다.

GPOLink

GPO에 대한 링크 정보를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

GPLinkUnknown

사용할 수 있는 링크 정보가 없습니다.

GPLinkMachine

GPO는 컴퓨터(로컬 또는 원격)에 연결됩니다.

GPLinkSite

GPO는 사이트에 연결됩니다.

GPLinkDomain

GPO는 도메인에 연결됩니다.

GPLinkOrganizationalUnit

GPO는 조직 구성 단위에 연결됩니다.

lParam

사용자가 제공한 데이터입니다.

pNext

목록의 다음 GPO에 대한 포인터입니다.

pPrev

목록의 이전 GPO에 대한 포인터입니다.

lpExtensions

이 GPO에 데이터를 저장한 확장입니다. 형식은 대괄호로 그룹화된 GUID문자열입니다. 자세한 내용은 다음 설명 섹션을 참조하세요.

lParam2

사용자가 제공한 데이터입니다.

lpLink

이 GPO가 연결된 Active Directory 사이트, 도메인 또는 조직 구성 단위의 경로입니다. GPO가 로컬 GPO에 연결된 경우 이 멤버는 "로컬"입니다.

발언

각 GPO에는 여러 스냅인 확장에서 처리해야 하는 데이터가 포함될 수 있습니다. 따라서 lpExtensions 멤버의 데이터는 확장 및 스냅인 확장을 식별하는 일련의 GUID구성됩니다. 데이터 형식은 다음과 같습니다.

[ext_guid1, snap_in_guid1, snap_in_guid2, ...] 
[ext_guid2, snap_in_guid3, snap_in_guid4, ...]

첫째, 확장의 GUID 뒤에 여는 대괄호 "["가 있습니다. 다음으로 GPO에 데이터를 저장한 스냅인 확장을 식별하는 하나 이상의 GUID찾을 수 있습니다. 확장에 대한 마지막 스냅인 GUID 후 닫는 대괄호 "]"가 있습니다. 이 패턴은 다음 확장에 대해 반복됩니다.

메모

userenv.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 GROUP_POLICY_OBJECT 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
헤더	userenv.h

참고 항목

FreeGPOList

GetGPOList

그룹 정책 개요

그룹 정책 구조

다음을 통해 공유